D3DDDICB_RENDER構造体 (d3dumddi.h)

[アーティクル]
02/06/2025

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

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

CommandOffset

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

NumAllocations

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

NumPatchLocations

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

pNewCommandBuffer

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

NewCommandBufferSize

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

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

pNewAllocationList

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

NewAllocationListSize

[入力/出力]ユーザーモードディスプレイドライバーが次の割り当てリストに対して要求する要素の数。

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

pNewPatchLocationList

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

NewPatchLocationListSize

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

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

Flags

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

hContext

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

BroadcastContextCount

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

BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

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

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

QueuedBufferCount

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

NewCommandBuffer

このメンバーは予約されており、0 に設定する必要があります。

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

pPrivateDriverData

[in]このメンバーは予約されており、0 に設定する必要があります。

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

PrivateDriverDataSize

[in]このメンバーは予約されており、0 に設定する必要があります。

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

MarkerLogType

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

RenderCBSequence

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

FirstAPISequenceNumberHigh