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

사용자 모드 표시 드라이버가 지원하는 ETW(Windows용 이벤트 추적) 로그의 표식 유형을 나타내는 D3DDDI_MARKERLOGTYPE 열거형입니다.

RenderCBSequence

각 pfnRenderCb 함수 호출에 대한 고유 식별자입니다. 단일 스레드 사용자 모드 DDIS와 연결된 컨텍스트의 경우 1 값으로 시작하고 자유 스레드 사용자 모드 DDI와 연결된 컨텍스트의 경우 0x80000001 값까지 범위가 지정됩니다. 사용자 모드 표시 드라이버는 모든 엔진에서 호출할 각 pfnRenderCb에 대한 값을 증가시켜야 합니다.

FirstAPISequenceNumberHigh