DXGKCB_COMPLETEFSTATETRANSITION回调函数 (d3dkmddi.h)

  • 项目

DXGKCB_COMPLETEFSTATETRANSITION 通知端口驱动程序电源组件已完成 F 状态转换。

语法

DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;

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

参数

[in] hAdapter

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

[in] ComponentIndex

DXGKARG_QUERYADAPTERINFO指定的电源组件索引。对 DxgkDdiQueryAdapterInfo 函数的调用中的 pInputData。

返回值

无

备注

在组件注册期间，显示微型端口驱动程序应通过设置DXGK_POWER_COMPONENT_FLAGS来指示需要调用DXGKCB_COMPLETEFSTATETRANSITION函数的所有电源组件。DriverCompletesFStateTransition 成员为 1。 设置此成员后，驱动程序必须以同步或异步方式调用此函数。 相反，如果未设置此成员，驱动程序不应调用此函数。

注意

如果 DXGK_POWER_COMPONENT_FLAGS。DriverCompletesFStateTransition 已设置，但驱动程序不调用此函数，可能会出现死锁。

Windows 电源管理框架保证在调用此函数之前不会为组件发送新的转换请求。

通常，端口驱动程序预期当此函数返回时，F 状态转换完成。 在某些情况下，显示微型端口驱动程序无法同步完成转换，例如，如果显示微型端口驱动程序无法在 DISPATCH_LEVEL完成转换，或者它需要激活其他电源组件。 此函数可帮助显示微型端口驱动程序异步完成 F 状态转换。

DXGKCB_XXX 函数由 Dxgkrnl 实现。 若要使用此回调函数，请设置 DXGKARGCB_ALLOCATEPAGESFORMDL 的成员，然后通过 DXGKRNL_INTERFACE 调用 DxgkCbCompleteFStateTransition。

要求

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

另请参阅

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE