通过

DXGKDDI_CANCELCOMMAND回调函数 (d3dkmddi.h)

  • 项目

清理与直接内存访问关联的内部资源， (DMA) 数据包位于 GPU 计划程序的软件队列中，但由于设备进入错误状态而从未到达硬件队列。 此类错误状态通常是由 超时检测和恢复 (TDR) 事件引起的。

语法

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

参数

hAdapter

与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序之前在 DxgkDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 DirectX 图形内核子系统提供了此句柄。

pCancelCommand

指向 DXGKARG_CANCELCOMMAND 结构的指针，该结构指定要在命令从硬件队列中删除后清理的资源。

返回值

成功完成后返回 STATUS_SUCCESS 。 如果驱动程序改为返回错误代码，则操作系统会导致系统进行 bug 检查。 有关更多信息，请参见下面的“备注”部分。

注解

注意 DirectX 图形内核子系统仅在 DXGK_VIDSCHCAPS时才调用此函数。已设置 CancelCommandAware 成员。
 
如果驱动程序返回错误代码，DirectX 图形内核子系统会导致系统进行 bug 检查。 在故障转储文件中，错误由 BugCheck 0x119 消息指出，该消息具有以下四个参数。
  1. 0x9
  2. 从失败的驱动程序调用返回的 NTSTATUS 错误代码
  3. 指向 DXGKARG_CANCELCOMMAND 结构的指针
  4. 指向内部计划程序数据结构的指针

要求

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

另请参阅

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice