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

ユーザーモードディスプレイドライバーがサポートする Windows イベントトレーシング (ETW) ログのマーカーの種類を示す D3DDDI_MARKERLOGTYPE 列挙体。

RenderCBSequence

pfnRenderCb関数呼び出しごとの一意識別子。シングルスレッドユーザーモードの DDI に関連付けられているコンテキストの場合は値 1 から始まり、フリースレッドユーザーモードの DDI に関連付けられているコンテキストの場合は 0x80000001 の値に範囲を指定します。ユーザーモードのディスプレイドライバーは、pfnRenderCb 任意のエンジンで呼び出すごとに値をインクリメントする必要があります。

FirstAPISequenceNumberHigh