DxgkCbCompleteFStateTransition routine

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 APIENTRY CALLBACK* DxgkCbCompleteFStateTransition(
  _In_ const HANDLE hAdapter,
             UINT   ComponentIndex
{ ... }


hAdapter [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

This routine does not return a 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, introduced version 10.0.10030.0


D3dkmddi.h (include D3dkmddi.h)



See also




Send comments about this topic to Microsoft

© 2015 Microsoft