DXGKDDI_RESETENGINE回调函数 (d3dkmddi.h)

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

语法

DXGKDDI_RESETENGINE DxgkddiResetengine;

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

参数

hAdapter

[in]与显示适配器关联的上下文块的句柄。 KMD 以前提供了此句柄,用于在 MiniportDeviceContextDxgkDdiAddDevice 函数的输出参数中 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