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

另请参阅

DXGKARG_RESUMEHWENGINE

DxgkDdiResetHwEngine