DXGKDDI_RESUMEHWENGINE回调函数 (d3dkmddi.h)
Dxgkrnl 在 GPU 引擎成功重置后调用 DxgkDdiResumeHwEngine,以指示 GPU 计划程序重新提交未因重置而失效的上下文。
语法
DXGKDDI_RESUMEHWENGINE DxgkddiResumehwengine;
NTSTATUS DxgkddiResumehwengine(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_RESUMEHWENGINE pResumeHwEngine
)
{...}
参数
hAdapter
[in]与显示适配器关联的上下文块的句柄。 KMD 之前在 DxgkDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 Dxgkrnl 提供了此句柄。
pResumeHwEngine
[in/out]指向 DXGKARG_RESUMEHWENGINE 结构的指针,该结构包含用于恢复硬件引擎的信息。
返回值
如果操作成功,DxgkDdiResumeHwEngine 将返回STATUS_SUCCESS。 否则,它应返回相应的 NTSTATUS 错误代码。 如果调用失败,OS 将执行完全 GPU 重置。
注解
调用 DxgkDdiResetHwEngine 后,引擎尚未被视为恢复,因此即使未失效的上下文也不允许提交。 OS 需要重新启用来自此引擎的中断,并将其状态与重置 GPU 引擎同步。 之后,OS 将启用中断并调用 DxgkDdiResumeHwEngine,这会指示 GPU 引擎开始计划不受引擎重置影响的所有可运行上下文。
在 **DRIVER_INITIALIZATION_DATA ** 结构中注册此回调函数的实现。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10版本 1703 (WDDM 2.2) |
标头 | d3dkmddi.h |