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.

Syntax


DXGKCB_COMPLETEFSTATETRANSITION DxgkCbCompleteFStateTransition;

VOID APIENTRY CALLBACK* DxgkCbCompleteFStateTransition(
  _In_  const HANDLE hAdapter,
  UINT ComponentIndex
)
{ ... }

Parameters

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.

ComponentIndex

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.

Remarks

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.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

<=DISPATCH_LEVEL

See also

DXGK_POWER_COMPONENT_FLAGS

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft