Skip to main content
バンドルを実行します。

構文

パラメーター

pCommandList [in]
型: ID3D12GraphicsCommandList *
実行するバンドルを決定する ID3D12GraphicsCommandList を指定します。

戻り値

型: void なし。

解説

バンドルは、パイプライン ステート オブジェクトとプリミティブ トポロジを除いて、ExecuteBundle が呼び出される親コマンド リストからすべての状態を継承します。 バンドル内で設定されたすべての状態は、親コマンド リストの状態に影響します。 ExecuteBundle は述語演算 (predicated operation) ではないことに注意してください。

ランタイム検証

ランタイムは、「呼び出し先」がバンドルであり、「呼び出し元」が直接コマンド リストであることを検証します。ランタイムはまた、バンドルが閉じていることも検証します。契約が違反された場合、ランタイムは呼び出しを暗黙的にドロップします。 検証の失敗は、Close が E_INVALIDARG を返す結果となります。

デバッグ レイヤー

デバッグ レイヤーは、ランタイムが失敗するのと同じケースで警告を発行します。 デバッグ レイヤーは、ExecuteCommandList が呼び出されたときに述語が設定されている場合、警告を発行します。 また、デバッグ レイヤーは、コマンド リストによって参照されるリソースが破棄されたことを検出した場合、エラーを発行します。
デバッグ レイヤーはさらに、バンドルに関連付けられたコマンド アロケーターが、コマンド リストで Close が呼び出されて以降リセットされていないことを検証します。この検証は、ExecuteBundle のタイミング、および親コマンド リストがコマンド キューで実行されるときに行われます。

D3D12Bundles サンプルでは、ID3D12GraphicsCommandList::ExecuteBundle を次のように使用しています。
D3D12 リファレンスのサンプル コード を参照してください。

要件

ヘッダー: d3d12_xs.h または d3d12_x.h
ライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされるプラットフォーム: XBOX Series 本体および XBOX One ファミリ

関連項目

ID3D12GraphicsCommandList
最終更新日 2026年8月24日