DXGKCB_SETPOWERCOMPONENTIDLE回调函数 (d3dkmddi.h)

  • 项目

显示微型端口驱动程序调用 DXGKCB_SETPOWERCOMPONENTIDLE 以通知 DirectX 图形内核子系统不再需要电源组件。 此函数返回后，显示微型端口驱动程序不得更改组件的硬件设置。

语法

DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;

void DxgkcbSetpowercomponentidle(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

参数

[in] hAdapter

显示适配器的句柄。 显示微型端口驱动程序在调用其 DxgkDdiStartDevice 函数时从 DXGKRNL_INTERFACE 结构的 DeviceHandle 成员接收句柄。

[in] ComponentIndex

由 DXGKARG_QUERYADAPTERINFO 指定的功率分量索引。对 DxgkDdiQueryAdapterInfo 函数的调用中的 pInputData。

返回值

无

备注

即使 DirectX 图形内核子系统管理组件的空闲状态，显示微型端口驱动程序也可以为任何类型的电源组件调用此函数。

DXGKCB_XXX 函数由 Dxgkrnl 实现。 若要使用此回调函数，请通过 DXGKRNL_INTERFACE调用 DxgkCbSetPowerComponentIdle。 对此函数的每个调用都必须与 对 DXGKCB_SETPOWERCOMPONENTACTIVE 函数的调用配对。

调用此函数时，组件的活动引用计数将减少 1。 电源管理框架维护引用计数，并且仅在引用计数变为零时将组件置于较低的 F 状态。

必须在 IRQL <= DISPATCH_LEVEL 调用此函数。 仅当组件类型为DXGK_POWER_COMPONENT_OTHER时，才能在 IRQL = DISPATCH_LEVEL调用它。

要求

要求 值
最低受支持的客户端 Windows 8 (WDDM 1.2)
最低受支持的服务器 Windows Server 2012
目标平台 桌面
标头 d3dkmddi.h (包括 D3dkmddi.h)
IRQL 请参见“备注”部分。

另请参阅

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice