DXGKDDI_RESETENGINE回调函数 (d3dkmddi.h)

显示端口驱动程序的 GPU 计划程序调用微型端口驱动程序的 (KMD 的) DxgkDdiResetEngine 函数，以在计划程序检测到适配器上的超时条件时重置物理显示适配器上的活动节点。

语法

DXGKDDI_RESETENGINE DxgkddiResetengine;

NTSTATUS DxgkddiResetengine(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_RESETENGINE pResetEngine
)
{...}

hAdapter

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

pResetEngine

[in/out] DXGKARG_RESETENGINE 结构，指定要重置的节点，并为最后一个中止的数据包提供围栏标识符。

如果函数成功，DxgkDdiResetEngine 将返回STATUS_SUCCESS。否则，此函数返回 Ntstatus.h 中定义的错误代码之一。

仅当满足以下所有条件时，KMD 才应从对此函数的调用返回：

此函数应可分页。

操作系统保证此函数遵循第一级同步模式。

有关详细信息，请参阅 Windows 8 中的 TDR 更改。