D3DDDICB_SUBMITCOMMAND structure (d3dumddi.h)
The D3DDDICB_SUBMITCOMMAND structure is used to submit command buffers on contexts that support graphics processing unit (GPU) virtual addressing.
Syntax
typedef struct _D3DDDICB_SUBMITCOMMAND {
D3DGPU_VIRTUAL_ADDRESS Commands;
UINT CommandLength;
D3DDDICB_SUBMITCOMMANDFLAGS Flags;
UINT BroadcastContextCount;
HANDLE BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
VOID *pPrivateDriverData;
UINT PrivateDriverDataSize;
UINT NumPrimaries;
D3DKMT_HANDLE WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES];
D3DDDI_MARKERLOGTYPE MarkerLogType;
UINT RenderCBSequence;
union {
struct {
UINT FirstAPISequenceNumberHigh;
UINT CompletedAPISequenceNumberLow0Size;
UINT CompletedAPISequenceNumberLow1Size;
UINT BegunAPISequenceNumberLow0Size;
UINT BegunAPISequenceNumberLow1Size;
};
UINT BatchedMarkerDataCount;
};
union {
struct {
const UINT *pCompletedAPISequenceNumberLow0;
const UINT *pCompletedAPISequenceNumberLow1;
const UINT *pBegunAPISequenceNumberLow0;
const UINT *pBegunAPISequenceNumberLow1;
};
const D3DDDI_BATCHEDMARKERDATA *pBatchedMarkerData;
};
UINT Reserved;
UINT NumHistoryBuffers;
D3DKMT_HANDLE *HistoryBufferArray;
HANDLE hSyncToken;
void *pReserved;
} D3DDDICB_SUBMITCOMMAND;
Members
Commands
GPU virtual address to the commands being submitted to the context for execution. This information is provided to the kernel mode driver during command submission and is also used for debugging purposes.
CommandLength
Specifies the length, in bytes, of the commands being submitted to the GPU. This information is provided to the kernel mode driver during command submission and is also used for debugging purposes.
Flags
An instance of the D3DDDICB_SUBMITCOMMANDFLAGS structure.
BroadcastContextCount
Specifies the number of context these command should be submitted to. This count must be at least 1.
BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]
Specifies the handle of the context to execute the specified commands.
pPrivateDriverData
Pointer to driver private data to be passed to the kernel mode driver as part of this submission.
PrivateDriverDataSize
Size of the private driver data information being passed. This size must be smaller than the size requested by the kernel mode driver for submission private driver data.
NumPrimaries
Specifies the number of primaries and swapchain back buffers being written to by the submitted commands. This is equal to the number of allocations in the WrittenPrimaries array.
WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES]
Arrays of handle to the primaries and swapchain back buffers being written to by the submitted commands.
MarkerLogType
A D3DDDI_MARKERLOGTYPE enumeration that indicates the type of marker in the Event Tracing for Windows (ETW) log that the user-mode display driver supports.
RenderCBSequence
A unique identifier for each pfnRenderCb function call. Starts at a value of 1 for contexts associated with single-threaded user-mode DDIs and ranges to a value of 0x80000001 for contexts associated with free-threaded user mode DDIs. The user-mode display driver must increment the value for each pfnRenderCb call it makes on any engine.
FirstAPISequenceNumberHigh
Used by the driver to pass the context's API sequence number.
CompletedAPISequenceNumberLow0Size
Used by the driver to pass the context's API sequence number.
CompletedAPISequenceNumberLow1Size
Used by the driver to pass the context's API sequence number.
BegunAPISequenceNumberLow0Size
Used by the driver to pass the context's API sequence number.
BegunAPISequenceNumberLow1Size
Used by the driver to pass the context's API sequence number.
BatchedMarkerDataCount
Used by the driver to pass the context's batched marker data count.
pCompletedAPISequenceNumberLow0
A pointer used by the driver to pass the context's API sequence number.
pCompletedAPISequenceNumberLow1
A pointer used by the driver to pass the context's API sequence number.
pBegunAPISequenceNumberLow0
A pointer used by the driver to pass the context's API sequence number.
pBegunAPISequenceNumberLow1
A pointer used by the driver to pass the context's API sequence number.
pBatchedMarkerData
A pointer used by the driver to pass the context's batched marker data.
Reserved
This member is reserved and should be set to zero.
NumHistoryBuffers
The number of history buffers.
HistoryBufferArray
A pointer to the array of history buffers.
hSyncToken
pReserved
Remarks
The pfnSubmitCommandCb code path no longer provides an allocation list for the user mode driver to provide a list of allocations that will be read and written to during this command. However, it is necessary to synchronize some writes that would not normally be known without the allocation list. For this, a new small allocation list specifically for surfaces which will be written to and used for displaying content. The WrittenPrimaries array should be used to provide such allocations.
Despite the name, WrittenPrimaries must contain allocations that are considered SwapChainBackBuffer allocations according to the runtime in addition to the primaries. This is exposed to the user mode driver by a new flag in D3D10_DDI_RESOURCE_MISC_FLAG. The runtime will provide the D3DWDDM2_0DDI_RESOURCE_MISC_DISPLAYABLE_SURFACE flag to the user mode driver during calls to create a resource or heap that is created as a FlipEx swapchain or primary. The driver may use this flag to determine all allocations that should be put in the WrittenPrimaries list for Microsoft Direct3D 11. Other runtimes have not changed.
If the driver receives a call to CreateResource that has this flag, the allocation should be added to this list on every pfnSubmitCommandCb call that writes to the surface.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10 |
| Minimum supported server | Windows Server 2016 |
| Header | d3dumddi.h (include D3dumddi.h) |