ID3D12PipelineLibrary1::LoadPipeline メソッド (d3d12.h)

ライブラリから要求された PSO を取得します。 パイプライン ストリームの説明はライブラリ データベースと照合され、PSO コンテンツの重複を防ぐために記憶されます。

構文

HRESULT LoadPipeline(
  [in]  LPCWSTR                                pName,
  [in]  const D3D12_PIPELINE_STATE_STREAM_DESC *pDesc,
        REFIID                                 riid,
  [out] void                                   **ppPipelineState
);

パラメーター

[in] pName

種類: LPCWSTR

SAL: In

PSO の一意の名前。

[in] pDesc

型: const D3D12_PIPELINE_STATE_STREAM_DESC*

SAL: In

D3D12_PIPELINE_STATE_STREAM_DESC構造体を使用して必要な PSO について説明します。 この説明はライブラリ データベースと照合され、PSO コンテンツの重複を防ぐために格納されます。

riid

種類: REFIID

ID3D12PipelineState オブジェクトの REFIID を指定します。

通常、アプリでは、マクロ IID_PPV_ARGS(&PSO1) を使用して、この引数と次の引数 ppPipelineState を設定する必要があります。ここで、PSO1 はオブジェクトの名前です。

[out] ppPipelineState

型: void**

SAL: COM_Outptr

関数が正常に戻った後に PSO を参照するポインターを指定します。

戻り値

種類: HRESULT

このメソッドは HRESULT の成功またはエラー コードを返します。このコードには、名前が存在しないか、ストリームの説明がライブラリ内のデータと一致しない場合はE_INVALIDARGを含め、関数が結果の PSO を割り当てることができない場合はE_OUTOFMEMORY。

注釈

この関数は、パイプラインの説明を D3D12_PIPELINE_STATE_STREAM_DESC として受け取り、 ID3D12PipelineLibrary::LoadGraphicsPipeline 関数と ID3D12PipelineLibrary::LoadComputePipeline 関数に代わる関数であり、それぞれパイプラインの説明を柔軟性の低い D3D12_GRAPHICS_PIPELINE_STATE_DESC と D3D12_COMPUTE_PIPELINE_STATE_DESC 構造体として受け取ります。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	d3d12.h
Library	D3d12.lib
[DLL]	D3d12.dll

こちらもご覧ください

ストリーミング パイプライン desc のレイアウトと動作の説明については、「 D3D12_PIPELINE_STATE_STREAM_DESC 」を参照してください。

ID3D12PipelineLibrary1