D3DDDICB_SUBMITCOMMAND Struktur (d3dumddi.h)

Artikel
02/06/2025

Die D3DDDICB_SUBMITCOMMAND Struktur wird verwendet, um Befehlspuffer in Kontexten zu übermitteln, die die virtuelle Adressierung der Grafikverarbeitungseinheit (GPU) unterstützen.

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;

Angehörige

Commands

VIRTUELLE GPU-Adresse an die Befehle, die für die Ausführung an den Kontext übermittelt werden. Diese Informationen werden dem Kernelmodustreiber während der Befehlsübermittlung bereitgestellt und werden auch für Debuggingzwecke verwendet.

CommandLength

Gibt die Länge der an die GPU übermittelten Befehle in Bytes an. Diese Informationen werden dem Kernelmodustreiber während der Befehlsübermittlung bereitgestellt und werden auch für Debuggingzwecke verwendet.

Flags

Eine Instanz der D3DDDICB_SUBMITCOMMANDFLAGS-Struktur.

BroadcastContextCount

Gibt die Anzahl des Kontexts an, an den dieser Befehl übermittelt werden soll. Diese Anzahl muss mindestens 1 sein.

BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Gibt das Handle des Kontexts an, mit dem die angegebenen Befehle ausgeführt werden sollen.

pPrivateDriverData

Zeiger auf private Treiberdaten, die als Teil dieser Übermittlung an den Kernelmodustreiber übergeben werden sollen.

PrivateDriverDataSize

Die Größe der datendaten des privaten Treibers, die übergeben werden. Diese Größe muss kleiner als die größe sein, die vom Kernelmodustreiber für die Übermittlung privater Treiberdaten angefordert wird.

NumPrimaries

Gibt die Anzahl der Primar- und Swapchainbackpuffer an, in die die übermittelten Befehle geschrieben werden. Dies entspricht der Anzahl der Zuordnungen im WrittenPrimaries Arrays.

WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES]

Arrays of handle to the primaries and swapchain back buffers being written to the submitted commands.

MarkerLogType

Eine D3DDDI_MARKERLOGTYPE Enumeration, die den Typ der Markierung im Ereignisablaufverfolgungsprotokoll für Windows (ETW) angibt, das der Anzeigetreiber für den Benutzermodus unterstützt.

RenderCBSequence

Ein eindeutiger Bezeichner für jeden pfnRenderCb- Funktionsaufruf. Beginnt bei einem Wert von 1 für Kontexte, die mit DDIs für den Einzelthreadmodus verknüpft sind, und bereiche auf einen Wert von 0x80000001 für Kontexte, die mit Freithreadmodus-DDIs verknüpft sind. Der Anzeigetreiber für den Benutzermodus muss den Wert für jeden pfnRenderCb aufrufen, der für jedes Modul ausgeführt wird.

FirstAPISequenceNumberHigh