DxgkCbSetPowerComponentActive routine

Called by the display miniport driver 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 APIENTRY CALLBACK* DxgkCbSetPowerComponentActive(
  _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

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

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGKARG_QUERYADAPTERINFO
DxgkCbSetPowerComponentIdle
DxgkDdiQueryAdapterInfo
DxgkDdiSetPowerComponentFState
DxgkDdiStartDevice
DXGKRNL_INTERFACE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft