DXGKARG_SUBMITCOMMANDVIRTUAL结构（d3dkmddi.h）

项目
02/06/2025

DXGKARG_SUBMITCOMMANDVIRTUAL 用于将直接内存访问（DMA）缓冲区提交到支持使用 DxgkDdiSubmitCommandVirtual设备驱动程序接口（DDI）进行虚拟寻址的上下文。

语法

typedef struct _DXGKARG_SUBMITCOMMANDVIRTUAL {
  HANDLE                         hContext;
  D3DGPU_VIRTUAL_ADDRESS         DmaBufferVirtualAddress;
  UINT                           DmaBufferSize;
  VOID                           *pDmaBufferPrivateData;
  UINT                           DmaBufferPrivateDataSize;
  UINT                           DmaBufferUmdPrivateDataSize;
  UINT                           SubmissionFenceId;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
  DXGK_SUBMITCOMMANDFLAGS        Flags;
  UINT                           EngineOrdinal;
  UINT                           NodeOrdinal;
} DXGKARG_SUBMITCOMMANDVIRTUAL;

成员

hContext

从 DxgkDdiCreateContext返回的句柄。

DmaBufferVirtualAddress

提交过程的上下文中 DMA 缓冲区的虚拟地址。

DmaBufferSize

DMA 缓冲区的大小（以字节为单位）。

pDmaBufferPrivateData

指向驱动程序专用数据缓冲区的指针。

DmaBufferPrivateDataSize

驱动程序专用数据缓冲区的大小（以字节为单位）。

DmaBufferUmdPrivateDataSize

SubmitCommandCb中用户模式驱动程序设置的专用驱动程序数据的大小（以字节为单位）。调用 SubmitCommandCb 时，DirectX 图形内核将为大小等于 DXGK_CONTEXTINFO：：DmaBufferPrivateDataSize的专用驱动程序数据分配缓冲区。 DxgkDdiCreateContext 调用中内核模式驱动程序报告了此大小。 DirectX 图形内核将驱动程序专用数据从 SubmitCommandCb 复制到分配的缓冲区。

SubmissionFenceId

驱动程序可以写入环形缓冲区中的围栏命令的唯一标识符，该缓冲区是 DMA 缓冲区排队等待 GPU 运行的缓冲区。有关这些类型的标识符的详细信息，请参阅提供围栏标识符。

VidPnSourceId

视频演示网络（VidPN）拓扑路径中视频演示源的从零开始的标识号，用于翻转作。仅当 Flip 或 FlipWithNoWait 位字段标志在标志成员中设置时，此成员才有效。

FlipInterval

一个 D3DDDI_FLIPINTERVAL_TYPE类型的值，该值指示翻转间隔（即，如果翻转发生在零、一、二、三或四个垂直同步之后）。 FlipInterval 仅在标志成员中设置 Flip 位字段标志（即 true）时有效。

Flags

一个 DXGK_SUBMITCOMMANDFLAGS 结构，用于标识要提交的 DMA 缓冲区的相关信息。

EngineOrdinal

保留以供将来使用。

NodeOrdinal

为上下文创建的节点的从零开始的索引。当上下文 NULL时标识节点。