Edit

Share via


DXGKARG_SUBMITCOMMANDVIRTUAL structure (d3dkmddi.h)

The DXGKARG_SUBMITCOMMANDVIRTUAL structure is passed to DxgkDdiSubmitCommandVirtual to submit a DMA buffer to a context that supports virtual addressing.

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's private data buffer.

DmaBufferPrivateDataSize

The size of the driver's private data buffer in bytes.

DmaBufferUmdPrivateDataSize

Size of the private driver data, in bytes, that was set by the user mode driver (UMD) in SubmitCommandCb. When SubmitCommandCb is called, Dxgkrnl 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 (KMD) in its DxgkDdiCreateContext call. Dxgkrnl copies the driver's 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