структура D3DDDICB_SUBMITCOMMAND (d3dumddi.h)

Статья
02/06/2025

Структура D3DDDICB_SUBMITCOMMAND используется для отправки буферов команд в контекстах, поддерживающих виртуальную адресацию графического модуля обработки (GPU).

Синтаксис

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;

Члены

Commands

Виртуальный адрес GPU для команд, отправляемых в контекст для выполнения. Эти сведения предоставляются драйверу режима ядра во время отправки команд и также используются для отладки.

CommandLength

Указывает длину в байтах команд, отправляемых в GPU. Эти сведения предоставляются драйверу режима ядра во время отправки команд и также используются для отладки.

Flags

Экземпляр структуры D3DDDICB_SUBMITCOMMANDFLAGS.

BroadcastContextCount

Указывает количество контекста, в который должна быть отправлена команда. Это число должно быть не менее 1.

BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Задает дескриптор контекста для выполнения указанных команд.

pPrivateDriverData

Указатель на частные данные драйвера, передаваемые драйверу режима ядра в рамках этой отправки.

PrivateDriverDataSize

Размер передаваемых данных частного драйвера. Этот размер должен быть меньше размера, запрошенного драйвером режима ядра для отправки данных частного драйвера.

NumPrimaries

Указывает количество первичных буферов и буферов цепочки буферов, записываемых в отправленные команды. Это равно количеству выделений в массиве WrittenPrimaries.

WrittenPrimaries[D3DDDI_MAX_WRITTEN_PRIMARIES]

Массивы дескриптора к первичным и буферам цепочки буферов обратной цепочки, записываемые в отправленные команды.

MarkerLogType

Перечисление D3DDDI_MARKERLOGTYPE, указывающее тип маркера в журнале трассировки событий для Windows (ETW), который поддерживает драйвер отображения в пользовательском режиме.

RenderCBSequence

Уникальный идентификатор для каждого вызова функции pfnRenderC b. Начинается со значения 1 для контекстов, связанных с однопоточными идентификаторами DDIs и диапазонами до значения 0x80000001 для контекстов, связанных с DD В свободном потоке пользовательского режима. Драйвер отображения в пользовательском режиме должен увеличивать значение для каждого pfnRenderCb вызывать его на любом обработчике.

FirstAPISequenceNumberHigh