構文
パラメーター
pCommandList [in]型: ID3D12GraphicsCommandList * 実行するバンドルを決定する ID3D12GraphicsCommandList を指定します。
戻り値
型: void なし。解説
バンドルは、パイプライン ステート オブジェクトとプリミティブ トポロジを除いて、ExecuteBundle が呼び出される親コマンド リストからすべての状態を継承します。 バンドル内で設定されたすべての状態は、親コマンド リストの状態に影響します。 ExecuteBundle は述語演算 (predicated operation) ではないことに注意してください。ランタイム検証
ランタイムは、「呼び出し先」がバンドルであり、「呼び出し元」が直接コマンド リストであることを検証します。ランタイムはまた、バンドルが閉じていることも検証します。契約が違反された場合、ランタイムは呼び出しを暗黙的にドロップします。 検証の失敗は、Close が E_INVALIDARG を返す結果となります。デバッグ レイヤー
デバッグ レイヤーは、ランタイムが失敗するのと同じケースで警告を発行します。 デバッグ レイヤーは、ExecuteCommandList が呼び出されたときに述語が設定されている場合、警告を発行します。 また、デバッグ レイヤーは、コマンド リストによって参照されるリソースが破棄されたことを検出した場合、エラーを発行します。 デバッグ レイヤーはさらに、バンドルに関連付けられたコマンド アロケーターが、コマンド リストで Close が呼び出されて以降リセットされていないことを検証します。この検証は、ExecuteBundle のタイミング、および親コマンド リストがコマンド キューで実行されるときに行われます。例
D3D12Bundles サンプルでは、ID3D12GraphicsCommandList::ExecuteBundle を次のように使用しています。要件
ヘッダー: d3d12_xs.h または d3d12_x.hライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされるプラットフォーム: XBOX Series 本体および XBOX One ファミリ
