> ## 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.

# CreatePipelineState

> 從管線狀態串流描述建立管線狀態物件。

從管線狀態串流描述建立管線狀態物件。

## 語法

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

### 參數

*pDesc*<br />類型：const D3D12\_PIPELINE\_STATE\_STREAM\_DESC \*

描述管線狀態之 [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public) 結構的位址。

*riid*<br />類型：const IID &

管線狀態介面 ([ID3D12PipelineState](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12PipelineState/id3d12pipelinestate_xs)) 的全域唯一識別碼 (**GUID**)。

管線狀態介面的 **REFIID** (或 **GUID**) 可以使用 \_\_uuidof() 巨集取得。例如，\_\_uuidof(ID3D12PipelineState) 會取得管線狀態介面的 **GUID**。

*ppPipelineState \[out]*<br />類型：void \*\*

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

記憶體區塊的指標，該區塊會接收管線狀態物件之 [ID3D12PipelineState](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12PipelineState/id3d12pipelinestate_xs) 介面的指標。

管線狀態物件是不可變的狀態物件。它不包含任何方法。

### 傳回值

類型：HRESULT

如果記憶體不足而無法建立管線狀態物件，此方法會傳回 **E\_OUTOFMEMORY**。如需其他可能的傳回值，請參閱 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)。

## 備註

此函式會以 [D3D12\_PIPELINE\_STATE\_STREAM\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public) 形式接受管線描述，並結合 [ID3D12Device::CreateGraphicsPipelineState](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_creategraphicspipelinestate_public) 和 [ID3D12Device::CreateComputePipelineState](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcomputepipelinestate_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) 結構接受其管線描述。

<Note>
  警告：XBOX Series X|S 主機上的放大著色器有已知的穩定性和效能問題。Microsoft 不建議在 XBOX Series X|S 主機上使用它們。
</Note>

## 需求

**標頭：** d3d12\_xs.h 或 d3d12\_x.h<br />**程式庫：** d3d12\_xs.lib 或 d3d12\_x.lib<br />**支援的平台**：XBOX Series 主機與 XBOX One 系列

## 另請參閱

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

[ID3D12Device2](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device2/id3d12device2_public)


## Related topics

- [D3D12_PIPELINE_STATE_STREAM_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public.md)
- [OMSetDepthBounds](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_omsetdepthbounds_public.md)
- [CreateComputePipelineState](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcomputepipelinestate_public.md)
- [CreateGraphicsPipelineState](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_creategraphicspipelinestate_public.md)
- [D3D12_COMPUTE_PIPELINE_STATE_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_compute_pipeline_state_desc_public.md)