DXGKCB_SETPOWERCOMPONENTIDLE callback function (d3dkmddi.h)

A display miniport driver calls DXGKCB_SETPOWERCOMPONENTIDLE to notify the DirectX graphics kernel subsystem that a power component is no longer needed. After this function returns, the display miniport driver must not change the component's hardware settings.

Syntax

DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;

void DxgkcbSetpowercomponentidle(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

Parameters

[in] hAdapter

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.

[in] ComponentIndex

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

Return value

None

Remarks

The display miniport driver can call this function for any type of power component, even if the DirectX graphics kernel subsystem manages the idle state of the component.

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, call DxgkCbSetPowerComponentIdle via the DXGKRNL_INTERFACE. Each call to this function must be paired with a call to the DXGKCB_SETPOWERCOMPONENTACTIVE function.

When this function is called, the active reference count of the component is decreased by 1. The Power Management Framework maintains the reference count and places the component into a lower F-state only when the reference count becomes zero.

This function must be called at IRQL <= DISPATCH_LEVEL. It can be called at IRQL = DISPATCH_LEVEL only if the component type is DXGK_POWER_COMPONENT_OTHER.

Requirements

See also

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice