D3DDDICB_SUBMITCOMMAND構造体 (d3dumddi.h)

[アーティクル]
10/07/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

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

RenderCBSequence

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

FirstAPISequenceNumberHigh