DXGKCB_SETPOWERCOMPONENTIDLE回调函数 (d3dkmddi.h)
显示微型端口驱动程序调用 DXGKCB_SETPOWERCOMPONENTIDLE,以通知 DirectX 图形内核子系统不再需要电源组件。 此函数返回后,显示微型端口驱动程序不得更改组件的硬件设置。
语法
DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;
void DxgkcbSetpowercomponentidle(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex
)
{...}
参数
[in] hAdapter
显示适配器的句柄。 显示微型端口驱动程序从 DeviceHandle 成员接收 DXGKRNL_INTERFACE 结构的句柄,该 DxgkDdiStartDevice 函数的调用。
[in] ComponentIndex
由 DXGKARG_QUERYADAPTERINFO指定的电源组件索引。在调用 DxgkDdiQueryAdapterInfo 函数时,pInputData。
返回值
没有
言论
即使 DirectX 图形内核子系统管理组件的空闲状态,显示微型端口驱动程序也可以为任何类型的电源组件调用此函数。
DXGKCB_XXX 函数由 Dxgkrnl实现。 若要使用此回调函数,请通过 DXGKRNL_INTERFACE调用 DxgkCbSetPowerComponentIdle。 对此函数的每个调用都必须与对 DXGKCB_SETPOWERCOMPONENTACTIVE 函数的调用配对。
调用此函数时,组件的活动引用计数将减少 1。 Power Management Framework 维护引用计数,仅当引用计数变为零时,组件才会进入较低的 F 状态。
必须在 IRQL <= DISPATCH_LEVEL 调用此函数。 只有在组件类型 DXGK_POWER_COMPONENT_OTHER时,才能在 IRQL = DISPATCH_LEVEL调用它。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 8 (WDDM 1.2) |
支持的最低服务器 | Windows Server 2012 |
目标平台 | 桌面 |
标头 | d3dkmddi.h (包括 D3dkmddi.h) |
IRQL | 请参阅“备注”部分。 |