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。

您的應用程式通常應該使用 PSO1 IID_PPV_ARGS (&PSO1) 來設定此自變數和下列自變數 ppPipelineState，其中 PSO1 是對象的名稱。

[out] ppPipelineState

類型： void**

SAL： COM_Outptr

指定在函式成功傳回之後，將參考 PSO 的指標。

傳回值

類型： HRESULT

這個方法會傳回 HRESULT 成功或錯誤碼，如果名稱不存在，或數據流描述不符合連結庫中的數據，而且如果函式無法配置產生的 PSO，則E_OUTOFMEMORY包含E_INVALIDARG。

備註

此函式會採用管線描述作為 D3D12_PIPELINE_STATE_STREAM_DESC ，並取代 ID3D12PipelineLibrary：：LoadGraphicsPipeline 和 ID3D12PipelineLibrary：：LoadComputePipeline 函式，其會將管線描述分別作為較不具彈性 的D3D12_GRAPHICS_PIPELINE_STATE_DESC 和 D3D12_COMPUTE_PIPELINE_STATE_DESC 結構。

規格需求

另請參閱

如需串流管線還原的配置和行為描述，請參閱 D3D12_PIPELINE_STATE_STREAM_DESC 。

ID3D12PipelineLibrary1