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

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

[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 状态，以满足 延迟指定的延迟容差。

如果驱动程序将延迟设置为 Wdm.h) 中定义的PO_FX_UNKNOWN_TIME (值，则 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