通过

DXGKDDI_CANCELCOMMAND回调函数 （d3dkmddi.h）

  • 项目

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

语法

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

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

参数

hAdapter

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

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