Win32 API 日本語リファレンス
ホーム › Graphics.Direct3D12 › ID3D12GraphicsCommandList2

ID3D12GraphicsCommandList2

COM
📘 Microsoft Learn (日本語) · English
IID38c3e585-ff17-412c-9150-4fc6f9d72a28継承元ID3D12GraphicsCommandList1自前メソッド開始 vtbl66

公式ドキュメント

レンダリング用のグラフィックスコマンドのリストをカプセル化し、即値をバッファーへ直接書き込む機能をサポートするようにインターフェイスを拡張します。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 66 void WriteBufferImmediate(DWORD Count, D3D12_WRITEBUFFERIMMEDIATE_PARAMETER* pParams, D3D12_WRITEBUFFERIMMEDIATE_MODE* pModes)

コマンドストリームから直接、指定したバッファーの位置に複数の 32 ビット即値を書き込みます。(ID3D12GraphicsCommandList2.WriteBufferImmediate)

CountDWORDinpParams および pModes が指す D3D12_WRITEBUFFERIMMEDIATE_PARAMETER 構造体の数。
pParamsD3D12_WRITEBUFFERIMMEDIATE_PARAMETER*inCount と同じ数の D3D12_WRITEBUFFERIMMEDIATE_PARAMETER 構造体を格納する配列のアドレス。
pModesD3D12_WRITEBUFFERIMMEDIATE_MODE*inoptionalCount と同じ数の D3D12_WRITEBUFFERIMMEDIATE_MODE 構造体を格納する配列のアドレス。既定値は null です。null を渡すと、システムはすべての即値を D3D12_WRITEBUFFERIMMEDIATE_MODE_DEFAULT を使用して書き込みます。

解説(Remarks)

WriteBufferImmediate は、pParams で指定された値と書き込み先のそれぞれに対して 1 回ずつ、合計 Count 回の 32 ビット書き込みを実行します。

書き込み先のバッファー (リソース) は、WriteBufferImmediate の有効な書き込み先となるために D3D12_RESOURCE_STATE_COPY_DEST 状態である必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_ID3D12GraphicsCommandList2 "{38C3E585-FF17-412C-9150-4FC6F9D72A28}"
#usecom global ID3D12GraphicsCommandList2 IID_ID3D12GraphicsCommandList2 "{}"
#comfunc global ID3D12GraphicsCommandList2_WriteBufferImmediate  66 int,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。