> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LoadPipeline

> 從程式庫擷取所要求的 PSO。管線串流描述會與程式庫資料庫進行比對，並加以記住，以避免。

從程式庫擷取所要求的 PSO。管線串流描述會與程式庫資料庫進行比對，並加以記住，以避免 PSO 內容重複。

## 語法

```cpp theme={null}
HRESULT LoadPipeline(
    LPCWSTR pName,
    const D3D12_PIPELINE_STATE_STREAM_DESC  pDesc,
    const IID & riid,
    void  ppPipelineState
)
```

### 參數

*pName \[in]*\
類型：LPCWSTR

[SAL](https://learn.microsoft.com/en-us/cpp/code-quality/annotating-function-parameters-and-return-values): <code>*In*</code>

PSO 的唯一名稱。

*pDesc \[in]*\
類型：const D3D12\_PIPELINE\_STATE\_STREAM\_DESC \*

[SAL](https://learn.microsoft.com/en-us/cpp/code-quality/annotating-function-parameters-and-return-values): <code>*In*</code>

使用 [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public) 結構描述所需的 PSO。此描述會與程式庫資料庫進行比對，並加以儲存，以避免 PSO 內容重複。

*riid*\
類型：const IID &

指定 ID3D12PipelineStateState 物件的 REFIID。

應用程式通常應使用巨集 IID\_PPV\_ARGS(\&PSO1) 設定此引數和下一個引數 ppPipelineState，其中 PSO1 是物件的名稱。

*ppPipelineState \[out]*\
類型：void \*\*

[SAL](https://learn.microsoft.com/en-us/cpp/code-quality/annotating-function-parameters-and-return-values): <code>*COM\_Outptr*</code>

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

### 傳回值

類型：HRESULT

此方法會傳回 HRESULT 成功或錯誤碼，其中可能包括：如果名稱不存在或串流描述與程式庫中的資料不符，則為 E\_INVALIDARG；如果函式無法配置產生的 PSO，則為 E\_OUTOFMEMORY。

## 備註

此函式接受 [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public) 形式的管線描述，用來取代 [ID3D12PipelineLibrary::LoadGraphicsPipeline](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadgraphicspipeline_public) 和 [ID3D12PipelineLibrary::LoadComputePipeline](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadcomputepipeline_public) 函式，這兩個函式分別以彈性較低的 [D3D12\_GRAPHICS\_PIPELINE\_STATE\_DESC](/zh-TW/reference/graphics/d3d12_x/structs/d3d12_graphics_pipeline_state_desc) 和 [D3D12\_COMPUTE\_PIPELINE\_STATE\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_compute_pipeline_state_desc_public) 結構接受其管線描述。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機和 XBOX One 系列

## 另請參閱

如需串流管線描述之配置和行為的說明，請參閱 [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public)。

[ID3D12PipelineLibrary1](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary1/id3d12pipelinelibrary1_public)


## Related topics

- [CreatePipelineLibrary](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device1/methods/id3d12device1_createpipelinelibrary_public.md)
- [LoadGraphicsPipeline](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadgraphicspipeline_public.md)
- [LoadComputePipeline](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_loadcomputepipeline_public.md)
- [ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH](/zh-TW/reference/audio/acphal/structs/acp_command_load_shape_flowgraph.md)
- [StorePipeline](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pipelinelibrary/methods/id3d12pipelinelibrary_storepipeline_public.md)