DXGKDDI_SUBMITCOMMANDVIRTUAL回调函数 (d3dkmddi.h)

项目
02/23/2024

DxgkDdiSubmitCommandVirtual 用于将直接内存访问 (DMA) 缓冲区提交到支持虚拟寻址的上下文。

驱动程序负责确保在提交特定 DMA 缓冲区之前还原正确的地址空间。

语法

DXGKDDI_SUBMITCOMMANDVIRTUAL DxgkddiSubmitcommandvirtual;

NTSTATUS DxgkddiSubmitcommandvirtual(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SUBMITCOMMANDVIRTUAL pSubmitCommand
)
{...}

参数

hAdapter

与显示适配器关联的上下文块的句柄。

pSubmitCommand

指向描述操作的DXGKARG_SUBMITCOMMANDVIRTUAL 结构的指针。

返回值

值	说明
STATUS_SUCCESS	提交的命令格式良好。
STATUS_INVALID_PARAMETER	DMA 或私有数据被确定为格式不正确。在这种情况下，OS 会将调用设备置于错误状态，并且其上的所有后续调用都将失败。传递给此调用的 SubmissionFenceId 值将在硬件上的所有先前数据包完成后被视为已完成，此时，最后完成的围栏 ID 的驱动程序概念应更新为此值。注意：此行为不同于 DxgkDdiSubmitCommand 调用，由于能够在以前的 DxgkDdiRender 调用中验证数据，因此不允许返回错误。

值

说明

STATUS_SUCCESS

提交的命令格式良好。

STATUS_INVALID_PARAMETER

DMA 或私有数据被确定为格式不正确。在这种情况下，OS 会将调用设备置于错误状态，并且其上的所有后续调用都将失败。传递给此调用的 SubmissionFenceId 值将在硬件上的所有先前数据包完成后被视为已完成，此时，最后完成的围栏 ID 的驱动程序概念应更新为此值。
注意： 此行为不同于 DxgkDdiSubmitCommand 调用，由于能够在以前的 DxgkDdiRender 调用中验证数据，因此不允许返回错误。

所有其他返回值将导致操作系统 错误检查。