構文
パラメーター
nodeMask [in]型: UINT シングル GPU 動作の場合は、これを 0 に設定します。GPU ノードが複数ある場合は、コマンド リストを作成するノード (デバイスの物理アダプター) を識別するビットを設定します。マスク内の各ビットは、単一のノードに対応します。設定するビットは 1 つだけである必要があります。マルチアダプター システム も参照してください。 type [in]
型: D3D12_COMMAND_LIST_TYPE 作成するコマンド リストのタイプを指定します。 pCommandAllocator [in]
型: ID3D12CommandAllocator * デバイスがコマンド リストを作成する元となるコマンド アロケーター オブジェクトへのポインター。 pInitialState [in, optional]
型: ID3D12PipelineState * コマンド リストの初期パイプライン状態を含むパイプライン ステート オブジェクトへの省略可能なポインター。
nullptr の場合、ランタイムはダミーの初期パイプライン状態を設定するため、ドライバーは未定義の状態を処理する必要がありません。このオーバーヘッドは小さく、特にコマンド リストの場合、コマンド リスト全体の記録コストが単一の初期状態設定コストをはるかに上回る可能性が高いです。したがって、初期パイプライン状態パラメーターを設定しないことによるコストはわずかであり、設定することが不便な場合はそうする必要はありません。
一方、バンドルの場合は、初期状態パラメーターを設定してみる方が理にかなっているかもしれません (バンドルは全体的に小さく、頻繁に再利用できる可能性が高いため)。
riid [in]型: const IID & ppCommandList で返されるコマンド リスト インターフェイスのグローバル一意識別子 (GUID) への参照。 ppCommandList [out]
型: void ** コマンド リストの ID3D12CommandList または ID3D12GraphicsCommandList インターフェイスへのポインターを受け取るメモリ ブロックへのポインター。
戻り値
型: HRESULT 関数が成功した場合、S_OK を返します。それ以外の場合は、HRESULT エラー コード を返します。
その他の戻り値については、Direct3D 12 の戻りコード を参照してください。
解説
デバイスはコマンド アロケーターからコマンド リストを作成します。例
D3D12Bundles サンプルでは、ID3D12Device::CreateCommandList を次のように使用しています。 パイプライン オブジェクトを作成します。要件
ヘッダー: d3d12_xs.h または d3d12_x.hライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされているプラットフォーム: XBOX Series 本体および XBOX One ファミリ