ID3D12GraphicsCommandList4::ExecuteMetaCommand メソッド (d3d12.h)
指定したメタ コマンドの実行 (または呼び出し) をグラフィックス コマンド リストに記録します。
メタ コマンドを実行する前に 、ID3D12GraphicsCommandList4::InitializeMetaCommand を呼び出します。 呼び出し中に、任意のランタイム パラメーターの値にオーバーライドを指定できます。 同じグラフィックス コマンド リストで複数のメタ コマンドを実行できます。 また、同じコマンド リストで同じメタ コマンドを複数回実行できます。
メタ コマンドを使用して PIX キャプチャを実行すると、同じハードウェア構成で再生できます。 ただし、設計上、他の GPU には移植できません。
構文
void ExecuteMetaCommand(
[in] ID3D12MetaCommand *pMetaCommand,
[in, optional] const void *pExecutionParametersData,
[in] SIZE_T ExecutionParametersDataSizeInBytes
);
パラメーター
[in] pMetaCommand
初期化するメタ コマンドを表す ID3D12MetaCommand へのポインター。
[in, optional] pExecutionParametersData
メタ コマンドを実行するためのパラメーターの値を含む定数構造体への省略可能なポインター。
[in] ExecutionParametersDataSizeInBytes
pExecutionParametersData が指す構造体のサイズを格納するSIZE_T (設定されている場合)、それ以外の場合は 0。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
アプリケーションは、meta コマンドの仕様に従って必要な状態でメタ コマンドに提供されるリソースを設定する役割を担います。 メタ コマンド定義の仕様では、各パラメーターに予想されるリソースの状態を定義します。 アプリケーションは、meta コマンドのアルゴリズムで使用される前に、入力リソースに対して順序なしのアクセス ビュー (UAV) バリアを挿入する必要があります。 出力リソースを読み戻す場合は、出力リソースの UAV バリアを挿入する必要もあります。
アルゴリズムの呼び出し中に、ドライバーは、アルゴリズムの実装で出力リソースの使用状況を同期するために必要な数の UAV バリアを出力リソースに挿入できます。 アプリケーションの観点からは、スクラッチ メモリを含め、すべての out リソースと in/out リソースが meta コマンドによって書き込まれると想定する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | d3d12.h |