Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

DxgkDdiSetPowerComponentFState routine

Called by the Microsoft DirectX graphics kernel subsystem to transition a power component to an idle state (an F-state).

Syntax


PDXGKDDISETPOWERCOMPONENTFSTATE DxgkDdiSetPowerComponentFState;

_Check_return_ NTSTATUS APIENTRY* DxgkDdiSetPowerComponentFState(
  _In_ const HANDLE DriverContext,
             UINT   ComponentIndex,
             UINT   FState
)
{ ... }

Parameters

DriverContext [in]

A handle to a context block associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.

ComponentIndex

The power component index specified by DXGKARG_QUERYADAPTERINFO.pInputData in a call to the DxgkDdiQueryAdapterInfo function.

FState

An F-state value that the display miniport driver has reported to the DirectX graphics kernel subsystem.

Return value

Returns STATUS_SUCCESS if it succeeds; otherwise, it returns STATUS_INVALID_PARAMETER.

Remarks

The operating system calls DxgkDdiSetPowerComponentFState only if the display miniport driver indicates support by setting DXGK_DRIVERCAPS.SupportRuntimePowerManagement to TRUE.

Note  To avoid a possible deadlock, do not call the DxgkCbSetPowerComponentActive function until this function has returned.

When the display miniport driver transitions a power component from the F0 (fully on) state to another F-state, it should save the context needed to later restore the component back to the F0 state.

The Power Management Framework only transitions a component to or from the F0 state.

This function can be called simultaneously from multiple execution threads. However, only one thread at a time can call this function to control a particular component.

The operating system guarantees that this function follows the zero level synchronization mode as defined in Threading and Synchronization Zero Level.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Target platform

Desktop

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

<=DISPATCH_LEVEL

See also

DXGK_DRIVERCAPS
DXGKARG_QUERYADAPTERINFO
DxgkCbSetPowerComponentActive
DxgkDdiAddDevice
DxgkDdiQueryAdapterInfo
DXGKRNL_INTERFACE

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft