Export (0) Print
Expand All

DxgkCbSetPowerComponentIdle routine

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 APIENTRY CALLBACK* DxgkCbSetPowerComponentIdle(
  _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

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

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

See Remarks section.

See also

DXGKARG_QUERYADAPTERINFO
DxgkCbSetPowerComponentActive
DxgkDdiQueryAdapterInfo
DxgkDdiStartDevice
DXGKRNL_INTERFACE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft