DXGKCB_SETPOWERCOMPONENTACTIVE callback function (d3dkmddi.h)
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 |