DXGKCB_COMPLETEFSTATETRANSITION callback function (d3dkmddi.h)

Called by a Windows Display Driver Model (WDDM) 1.2 or later display miniport driver to notify the port driver that a power component has completed the F-state transition.



void DxgkcbCompletefstatetransition(
  UINT ComponentIndex



[in] A handle to the display adapter. The display miniport driver receives the handle from the DeviceHandle member of the DXGKRNL_INTERFACE structure in a call to its DxgkDdiStartDevice function.


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

Return value



During component registration the display miniport driver should indicate all power components for which it will need to call the DxgkCbCompleteFStateTransition function by setting the DXGK_POWER_COMPONENT_FLAGS.DriverCompletesFStateTransition member to 1. When this member is set, the driver must call this function either synchronously or asynchronously. Conversely, if this member is not set, the driver should not call this function.

Note  If the DXGK_POWER_COMPONENT_FLAGS.DriverCompletesFStateTransition member has been set but the driver does not call this function, deadlocks might occur.
The Windows power management framework guarantees that no new transition request will be sent for the component until this function is called.

Usually the port driver expects that when this function returns, the F-state transition is completed. There could be scenarios when the display miniport driver cannot complete the transition synchronously, for example if the display miniport driver cannot complete the transitions at DISPATCH_LEVEL, or it needs to activate other power components. This function helps the display miniport driver to complete the F-state transition asynchronously.


Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header d3dkmddi.h (include D3dkmddi.h)

See also