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

Статья
10/05/2023

Структура 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

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

FirstAPISequenceNumberHigh