struttura D3DDDICB_SUBMITCOMMAND (d3dumddi.h)

Articolo
02/06/2025

La struttura D3DDDICB_SUBMITCOMMAND viene usata per inviare buffer dei comandi nei contesti che supportano l'indirizzamento virtuale dell'unità di elaborazione grafica (GPU).

Sintassi

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;

Membri

Commands

Indirizzo virtuale GPU ai comandi inviati al contesto per l'esecuzione. Queste informazioni vengono fornite al driver in modalità kernel durante l'invio del comando e vengono usate anche a scopo di debug.

CommandLength

Specifica la lunghezza, in byte, dei comandi inviati alla GPU. Queste informazioni vengono fornite al driver in modalità kernel durante l'invio del comando e vengono usate anche a scopo di debug.

Flags

Istanza della struttura D3DDDICB_SUBMITCOMMANDFLAGS.

BroadcastContextCount

Specifica il numero di contesto a cui deve essere inviato il comando. Questo conteggio deve essere almeno 1.

BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Specifica l'handle del contesto per eseguire i comandi specificati.

pPrivateDriverData

Puntatore ai dati privati del driver da passare al driver in modalità kernel come parte di questo invio.

PrivateDriverDataSize

Dimensioni delle informazioni sui dati del driver privato passate. Queste dimensioni devono essere inferiori alle dimensioni richieste dal driver in modalità kernel per l'invio di dati del driver privato.

NumPrimaries

Specifica il numero di primarie e buffer back swapchain in cui vengono scritti i comandi inviati. È uguale al numero di allocazioni nella matrice WrittenPrimaries.

WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES]

Matrici di handle per le primarie e i buffer back di swapchain in cui vengono scritti i comandi inviati.

MarkerLogType

Enumerazione D3DDDI_MARKERLOGTYPE che indica il tipo di marcatore nel log ETW (Event Tracing for Windows) supportato dal driver di visualizzazione in modalità utente.

RenderCBSequence

Identificatore univoco per ogni pfnRenderCb chiamata di funzione. Inizia con un valore pari a 1 per i contesti associati a DDI in modalità utente a thread singolo e intervalli a un valore di 0x80000001 per i contesti associati alle DDI in modalità utente a thread libero. Il driver di visualizzazione in modalità utente deve incrementare il valore per ogni pfnRenderCb chiamata eseguita su qualsiasi motore.

FirstAPISequenceNumberHigh