DXGKCB_SETPOWERCOMPONENTLATENCY回调函数 (d3dkmddi.h)

显示微型端口驱动程序调用 DXGKCB_SETPOWERCOMPONENTLATENCY 来设置 DXGK_POWER_COMPONENT_OTHER类型的电源组件的延迟容忍度。

语法

DXGKCB_SETPOWERCOMPONENTLATENCY DxgkcbSetpowercomponentlatency;

void DxgkcbSetpowercomponentlatency(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex,
  [in] ULONGLONG Latency
)
{...}

参数

[in] hAdapter

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

[in] ComponentIndex

DXGKARG_QUERYADAPTERINFO指定的电源组件索引。在调用 DxgkDdiQueryAdapterInfo 函数时,pInputData

[in] Latency

延迟容错(最大时间(以 100 纳秒为单位)显示微型端口驱动程序应从空闲状态唤醒电源组件。 Power Management Framework 使用此信息为不违反所请求延迟容错的组件选择适当的空闲状态。 延迟 指定的延迟容错仍然有效,直到驱动程序再次调用此函数来更新它。 请参阅“备注”。

返回值

没有

言论

注意

仅当组件类型 DXGK_POWER_COMPONENT_OTHER时,显示微型端口驱动程序才应调用此函数。 DirectX 图形内核子系统为其他组件类型设置延迟容错值。

DXGKCB_XXX 函数由 Dxgkrnl实现。 若要使用此回调函数,请通过 DXGKRNL_INTERFACE调用 DxgkCbSetPowerComponentLatency

如果在调用此函数时电源组件处于空闲状态,Power Management Framework 可能会更改组件的 F 状态,以满足 延迟指定的延迟容错。

如果驱动程序将 延迟 设置为 PO_FX_UNKNOWN_TIME 值(在 Wdm.h中定义),则 Power Engine 插件(PEP)可能无法将组件设置为低于 F0 的 F 状态。

要求

要求 价值
最低支持的客户端 Windows 8 (WDDM 1.2)
支持的最低服务器 Windows Server 2012
目标平台 桌面
标头 d3dkmddi.h (包括 D3dkmddi.h)
IRQL <= DISPATCH_LEVEL

另请参阅

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice