DXGKARG_SUBMITCOMMANDVIRTUAL structure (d3dkmddi.h)

DXGKARG_SUBMITCOMMANDVIRTUAL is used to submit a direct memory access (DMA) buffer to a context that supports virtual addressing with the DxgkDdiSubmitCommandVirtualdevice driver interface (DDI).

Syntax

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;

Members

hContext

The handle returned from DxgkDdiCreateContext.

DmaBufferVirtualAddress

The virtual address for the DMA buffer in the context of the submitting process.

DmaBufferSize

The size of the DMA buffer in bytes.

pDmaBufferPrivateData

A pointer to the driver-private data buffer.

DmaBufferPrivateDataSize

The size of the driver-private data buffer in bytes.

DmaBufferUmdPrivateDataSize

Size of the private driver data, in bytes, that was set by the user mode driver in SubmitCommandCb. When SubmitCommandCb is called, the DirectX graphics kernel allocates a buffer for the private driver data with the size equal to DXGK_CONTEXTINFO::DmaBufferPrivateDataSize. This size was reported by the kernel mode driver in the DxgkDdiCreateContext call. The DirectX graphics kernel copies the driver private data from the SubmitCommandCb to the allocated buffer.

SubmissionFenceId

A unique identifier that the driver can write into the fence command in the ring buffer, which is the buffer where DMA buffers are queued for the GPU to run. For more information about these types of identifiers, see Supplying Fence Identifiers.

VidPnSourceId

The zero-based identification number of the video present source in a path of a video present network (VidPN) topology for a flip operation. This member is valid only when the Flip or FlipWithNoWait bit-field flag is set in the Flags member.

FlipInterval

A D3DDDI_FLIPINTERVAL_TYPE-typed value that indicates the flip interval (that is, if the flip occurs after zero, one, two, three, or four vertical syncs). FlipInterval is valid only if the Flip bit-field flag is set (that is, TRUE) in the Flags member.

Flags

A DXGK_SUBMITCOMMANDFLAGS structure that identifies information about the DMA buffer to submit.

EngineOrdinal

Reserved for future use.

NodeOrdinal

The zero-based index of the node that the context is created for. Identifies the node when the context is NULL.

Requirements

Requirement Value
Minimum supported client Windows 10
Minimum supported server Windows Server 2016
Header d3dkmddi.h (include D3dkmddi.h)

See also

D3DDDI_FLIPINTERVAL_TYPE

DXGK_CONTEXTINFO

DxgkDdiCreateContext

DxgkDdiSubmitCommandVirtual

Supplying Fence Identifiers