DXGKCB_SETPOWERCOMPONENTRESIDENCY回调函数 （d3dkmddi.h）
内核模式显示微型端口驱动程序 DXGKCB_SETPOWERCOMPONENTRESIDENCY 调用，以设置 DXGK_POWER_COMPONENT_OTHER类型的电源组件的预期驻留。
语法
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
参数
[in] hAdapter
显示适配器的句柄。 显示微型端口驱动程序从 DeviceHandle 成员接收 DXGKRNL_INTERFACE 结构的句柄，该 DxgkDdiStartDevice 函数的调用。
[in] ComponentIndex
由 DXGKARG_QUERYADAPTERINFO指定的电源组件索引。在调用 DxgkDdiQueryAdapterInfo 函数时，pInputData。
[in] Residency
预期驻留（最大时间（以 100 纳秒为单位）显示微型端口驱动程序要求电源组件进入空闲状态后保持空闲状态。 Power Management Framework 使用此信息为不违反所请求驻留的组件选择适当的空闲状态。 驻留 指定的预期驻留一直有效，直到驱动程序再次调用此函数来更新它。 请参阅“备注”。
返回值
没有
言论
注意
仅当组件类型 DXGK_POWER_COMPONENT_OTHER时，显示微型端口驱动程序才应调用此函数。 DirectX 图形内核子系统为其他组件类型设置预期的驻留值。
DXGKCB_XXX 函数由 Dxgkrnl实现。 若要使用此回调函数，请通过 DXGKRNL_INTERFACE调用 DxgkCbSetPowerComponentResidency。
如果在调用此函数时电源组件处于空闲状态，则 Power Management Framework 可能会更改组件的 F 状态以满足 驻留指定的预期驻留值。
如果驱动程序将 驻留 设置为 PO_FX_UNKNOWN_TIME 的值（在 Wdm.h中定义），则电源引擎插件（PEP）可能无法将组件设置为低于 F0 的 F 状态。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 8 （WDDM 1.2） |
| 支持的最低服务器 | Windows Server 2012 |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | <= DISPATCH_LEVEL |