DXGKCB_SETPOWERCOMPONENTACTIVE回调函数 (d3dkmddi.h)
显示微型端口驱动程序调用 DXGKCB_SETPOWERCOMPONENTACTIVE 来访问电源组件。 此函数返回后，显示微型端口驱动程序可以更改组件的硬件设置。
语法
DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;
void DxgkcbSetpowercomponentactive(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex
)
{...}
参数
[in] hAdapter
显示适配器的句柄。 显示微型端口驱动程序在调用其 DxgkDdiStartDevice 函数时从 DXGKRNL_INTERFACE 结构的 DeviceHandle 成员接收句柄。
[in] ComponentIndex
由 DXGKARG_QUERYADAPTERINFO 指定的功率分量索引。对 DxgkDdiQueryAdapterInfo 函数的调用中的 pInputData。
返回值
无
备注
每次对此函数的调用都必须与 对 DXGKCB_SETPOWERCOMPONENTIDLE 函数的调用配对，以指示不再需要组件硬件。
调用此函数时，组件的活动引用计数将增加 1。 电源管理框架维护引用计数，并且仅在引用计数变为零时将组件置于较低的 F 状态。
调用此函数时，显示微型端口驱动程序可能会在另一个执行线程上收到对 DxgkDdiSetPowerComponentFState 函数的调用。
DXGKCB_XXX 函数由 Dxgkrnl 实现。 若要使用此回调函数，请通过 DXGKRNL_INTERFACE调用 DxgkCbSetPowerComponentActive。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 (WDDM 1.2) |
| 最低受支持的服务器 | Windows Server 2012 |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h (包括 D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |