D3DDDICB_SUBMITCOMMAND struttura (d3dumddi.h)

Articolo
10/07/2023

La struttura D3DDDICB_SUBMITCOMMAND viene usata per inviare i 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;

Members

Commands

Indirizzo virtuale GPU ai comandi inviati al contesto per l'esecuzione. Queste informazioni vengono fornite al driver in modalità kernel durante l'invio dei comandi e vengono usate anche per scopi 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 dei comandi e vengono usate anche per scopi di debug.

Flags

Istanza della struttura di 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. Questa dimensione deve essere inferiore alla dimensione richiesta dal driver in modalità kernel per l'invio dei dati del driver privato.

NumPrimaries

Specifica il numero di primaries e buffer back swapchain scritti dai comandi inviati. Uguale al numero di allocazioni nella matrice WrittenPrimary .

WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES]

Matrici di handle per le primarie e i buffer back swapchain scritti dai comandi inviati.

MarkerLogType

Un'enumerazione D3DDDI_MARKERLOGTYPE che indica il tipo di marcatore nel log di Traccia eventi per Windows (ETW) supportato dal driver di visualizzazione in modalità utente.

RenderCBSequence

Identificatore univoco per ogni chiamata di funzione pfnRenderCb . Inizia a un valore pari a 1 per i contesti associati alle DDI in modalità utente a thread singolo e agli 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 aumentare il valore per ogni chiamata pfnRenderCb in qualsiasi motore.

FirstAPISequenceNumberHigh