通过

DXGKDDI_RESETHWENGINE回调函数 （d3dkmddi.h）

  • 项目

Dxgkrnl 在需要 GPU 引擎重置时调用显示微型端口驱动程序（KMD）DxgkDdiResetHwEngine 函数。

语法

DXGKDDI_RESETHWENGINE DxgkddiResethwengine;

NTSTATUS DxgkddiResethwengine(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_RESETHWENGINE pResetHwEngine
)
{...}

参数

hAdapter

[in]与显示适配器关联的上下文块的句柄。 KMD 以前提供了此句柄，用于在 MiniportDeviceContextDxgkDdiAddDevice 函数的输出参数中 Dxgkrnl。

pResetHwEngine

[in/out]指向包含重置硬件引擎的信息的 DXGKARG_RESETHWENGINE 结构的指针。

返回值

如果作成功，则 DxgkDdiResetHwEngine 返回STATUS_SUCCESS。 否则，它应返回相应的 NTSTATUS 错误代码。

言论

DxgkDdiResetHwEngine 实现应调用 DxgkCbInvalidateHwContext 回调，以通知 OS 受 GPU 引擎重置作影响的所有正在运行的上下文。 OS 会使这些上下文设备失效（错误设置它们），并且不会执行将来的提交。

调用 dxgkDdiResetHwEngine 后，该引擎尚未被视为恢复，因此不允许提交未失效的上下文。 OS 需要重新启用来自此引擎的中断，并将其状态与重置 GPU 引擎同步。 之后，OS 将启用中断并调用 DxgkDdiResumeHwEngine，该命令 GPU 引擎开始计划不受引擎重置影响的所有可运行上下文。

在 **DRIVER_INITIALIZATION_DATA ** 结构中注册此回调函数的实现。

要求

要求 价值
最低支持的客户端 Windows 10 版本 1703 （WDDM 2.2）
标头 d3dkmddi.h

另请参阅

DXGKARG_RESETHWENGINE

DxgkDdiResumeHwEngine