DXGKCB_SETPOWERCOMPONENTIDLE callback function

Called by the display miniport driver to notify the Microsoft 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_CONST_HANDLE hAdapter,
  UINT ComponentIndex
)
{...}

Parameters

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.

ComponentIndex

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

Return Value

This callback function does not return a value.

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.

Each call to this function must be paired with a call to the DxgkCbSetPowerComponentActive 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

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

See Also

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkCbSetPowerComponentActive

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice