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_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 |