DXGKCB_SETPOWERCOMPONENTACTIVE callback function (d3dkmddi.h)

Article
02/22/2024

A display miniport driver calls DXGKCB_SETPOWERCOMPONENTACTIVE to access a power component. After this function returns, the display miniport driver can change the component's hardware settings.

Syntax

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

void DxgkcbSetpowercomponentactive(
  [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

Each call to this function must be paired with a call to the DXGKCB_SETPOWERCOMPONENTIDLE function to indicate that the component hardware is no longer required.

When this function is called, the active reference count of the component is increased 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.

While calling this function, the display miniport driver might receive a call to the DxgkDdiSetPowerComponentFState function on another execution thread.

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, call DxgkCbSetPowerComponentActive via the DXGKRNL_INTERFACE.

Requirements

Requirement	Value
Minimum supported client	Windows 8 (WDDM 1.2)
Minimum supported server	Windows Server 2012
Target Platform	Desktop
Header	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL