DXGKCB_COMPLETEFSTATETRANSITION回调函数 (d3dkmddi.h)

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

语法

DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;

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

参数

[in] hAdapter

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

[in] ComponentIndex

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

返回值

没有

言论

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

注意

如果 DXGK_POWER_COMPONENT_FLAGSDriverCompletesFStateTransition 已设置,但驱动程序未调用此函数,可能会发生死锁。

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