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 更改。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 桌面
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_RESETENGINE

DxgkDdiAddDevice