D3DDDICB_RENDER 構造体 (d3dumddi.h)

[アーティクル]
10/07/2023

D3DDDICB_RENDER構造体は、レンダリングされる現在のコマンドバッファーを記述します。

構文

typedef struct _D3DDDICB_RENDER {
  UINT                     CommandLength;
  UINT                     CommandOffset;
  UINT                     NumAllocations;
  UINT                     NumPatchLocations;
  VOID                     *pNewCommandBuffer;
  UINT                     NewCommandBufferSize;
  D3DDDI_ALLOCATIONLIST    *pNewAllocationList;
  UINT                     NewAllocationListSize;
  D3DDDI_PATCHLOCATIONLIST *pNewPatchLocationList;
  UINT                     NewPatchLocationListSize;
  D3DDDICB_RENDERFLAGS     Flags;
  HANDLE                   hContext;
  UINT                     BroadcastContextCount;
  HANDLE                   BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  ULONG                    QueuedBufferCount;
  D3DGPU_VIRTUAL_ADDRESS   NewCommandBuffer;
  VOID                     *pPrivateDriverData;
  UINT                     PrivateDriverDataSize;
  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;
  };
} D3DDDICB_RENDER;

メンバー

CommandLength

[入力]オフセット 0 から始まるコマンドバッファーのサイズ (バイト単位)。

CommandOffset

[入力]コマンドバッファー内の最初のコマンドへのオフセット (バイト単位)。

NumAllocations

[入力]割り当てリスト内の要素の数。

NumPatchLocations

[入力]パッチの場所リスト内の要素の数。

pNewCommandBuffer

[out]ユーザーモード表示ドライバーが pfnRenderCb 関数の次の呼び出しで使用するために受け取るコマンドバッファーへのポインター。

NewCommandBufferSize

[入力/出力]ユーザーモード表示ドライバーが次のコマンドバッファーを要求するサイズ (バイト単位)。

ドライバーは、使用する次のコマンドバッファーのサイズ (バイト単位) を受け取ります。

pNewAllocationList

[out]ユーザーモードディスプレイドライバーが pfnRenderCb 関数の次の呼び出しで割り当てリストとして使用するために受け取るD3DDDI_ALLOCATIONLIST構造体の配列。

NewAllocationListSize

[入力/出力]ユーザーモード表示ドライバーが次の割り当てリストを要求する要素の数。

ドライバーは、次のコマンドバッファーが送信されたときに使用できる割り当てリストの要素の数を受け取ります。

pNewPatchLocationList

[out]ユーザーモードディスプレイドライバーが pfnRenderCb 関数の次の呼び出しでパッチの場所リストとして使用するために受け取るD3DDDI_PATCHLOCATIONLIST構造体の配列。

NewPatchLocationListSize

[入力/出力]ユーザーモードでドライバーが次のパッチの場所の一覧を要求する要素の数。

ドライバーは、次のコマンドバッファーが送信されたときに使用できるパッチの場所の一覧の要素の数を受け取ります。

Flags

[入力]レンダリングするコマンドバッファーに関する情報を示す D3DDDICB_RENDERFLAGS 構造体。

hContext

[入力]ドライバーがレンダリング操作を送信するコンテキストへのハンドル。ユーザーモードディスプレイドライバーは、 以前に pfnCreateContextCb 関数を呼び出して、このコンテキストを作成しました。

BroadcastContextCount

[入力] BroadcastContext メンバーが指定する配列内の追加コンテキストの数。

BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

[入力]現在のコマンドバッファーをブロードキャストする追加のコンテキストへのハンドルの配列。 D3DDDI_MAX_BROADCAST_CONTEXT定数は 64 として定義され、ユーザーモードディスプレイドライバーが現在のコマンドバッファーをブロードキャストできる追加コンテキストの最大数を定義します。

hContext メンバーが指定し、コマンドバッファーを所有する元のコンテキストは、BroadcastContext 配列内の要素ではありません。たとえば、 BroadcastContext 配列に 1 つの要素が含まれている場合、ユーザーモードの表示ドライバーは、所有コンテキスト (hContext) にコマンドバッファーを送信し、その 1 つの追加のコンテキストにブロードキャストします。

QueuedBufferCount

[out]現在の送信が行われる後に hContext メンバーが指定するコンテキストにキューに入れられている DMA バッファーの数。

NewCommandBuffer

このメンバーは予約済みであり、0 に設定する必要があります。

このメンバーは、Windows 7 以降で使用できます。

pPrivateDriverData

[入力]このメンバーは予約済みであり、0 に設定する必要があります。

このメンバーは、Windows 7 以降で使用できます。

PrivateDriverDataSize

[入力]このメンバーは予約済みであり、0 に設定する必要があります。

このメンバーは、Windows 7 以降で使用できます。

MarkerLogType

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

RenderCBSequence

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

FirstAPISequenceNumberHigh