DXGKDDI_SUBMITCOMMAND回调函数 (d3dkmddi.h)

DxgkDdiSubmitCommand 函数将直接内存访问(DMA)缓冲区提交到硬件命令执行单元。

语法

DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;

NTSTATUS DxgkddiSubmitcommand(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}

参数

[in] hAdapter

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

[in] pSubmitCommand

指向 DXGKARG_SUBMITCOMMAND 结构的指针,该结构描述显示微型端口驱动程序提交到硬件命令执行单元的 DMA 缓冲区。

返回值

DxgkDdiSubmitCommand 成功完成后返回 STATUS_SUCCESS。 如果驱动程序改为返回错误代码,则作系统会导致系统 bug 检查发生。 请参阅“备注”。

言论

由于分页作被视为系统作,因此它们不与特定的应用程序上下文或图形上下文相关联。 因此,提交用于分页作时,会调用 DxgkDdiSubmitCommand 函数,并在 hDevice 成员中指定的hDeviceDXGKARG_SUBMITCOMMAND 成员 pSubmitCommand 参数指向该函数。

但是,如果特定硬件和驱动程序的体系结构必须在内部具有设备,驱动程序必须在适配器初始化期间内部创建设备,并且必须将设备作为系统默认设备在内部保留,以便在分页作中使用。

驱动程序可以将 SubmissionFenceId DXGKARG_SUBMITCOMMAND 成员中提供的值写入环形缓冲区中的围栏命令中。 有关围栏命令的详细信息,请参阅 提供围栏标识符

如果驱动程序返回错误代码,DirectX 图形内核子系统会导致系统 bug 检查发生。 在故障转储文件中,错误消息 BugCheck 0x119指出,该消息将具有以下四个参数。

  • 0x2(标识错误的原因)
  • 从失败的驱动程序调用返回的 NTSTATUS 错误代码
  • 指向 DXGKARG_SUBMITCOMMAND 结构的指针
  • 指向内部计划程序数据结构的指针

应将 DxgkDdiSubmitCommand 设置为不可分页,因为它在 IRQL = DISPATCH_LEVEL 上运行。

要求

要求 价值
最低支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h
IRQL DISPATCH_LEVEL

另请参阅

DXGKARG_SUBMITCOMMAND

DxgkDdiAddDevice