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

# CreateGraphicsPipelineStateX (XBOX One 系列)

> 建立包含其他詳細資料 (例如著色器限制，以及深度、樣板和像素著色器選項) 的圖形管線狀態物件。

建立包含其他詳細資料 (例如著色器限制，以及深度、樣板和像素著色器選項) 的圖形管線狀態物件。

## 語法

```cpp theme={null}
HRESULT CreateGraphicsPipelineStateX(  
         const D3D12_GRAPHICS_PIPELINE_STATE_DESC* pBaseDesc,  
         UINT NumExtendedDescs,  
         const D3D12XBOX_EXTENDED_GRAPHICS_PIPELINE_STATE_DESC* pExtendedDescs,  
         REFIID riid,  
         void** ppPipelineState  
)  
```

### 參數

*pBaseDesc*   \_In\_<br />類型：[D3D12\_GRAPHICS\_PIPELINE\_STATE\_DESC\*](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_graphics_pipeline_state_desc)

基本圖形管線狀態描述的位址。

*NumExtendedDescs*   \_In\_<br />類型：UINT

**pExtendedDescs** 中延伸圖形管線狀態描述的數目。

*pExtendedDescs*   \_In\_<br />類型：[D3D12XBOX\_EXTENDED\_GRAPHICS\_PIPELINE\_STATE\_DESC\*](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_extended_graphics_pipeline_state_desc)

指向延伸圖形管線狀態描述陣列的指標，這些描述會指定其他圖形管線狀態詳細資料，例如著色器限制，以及深度、樣板和像素著色器選項。

*riid*   \_In\_<br />類型：REFIID

管線狀態介面 [ID3D12PipelineState](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nn-d3d12-id3d12pipelinestate) 的全域唯一識別碼 (GUID)。

若要擷取管線狀態介面的 [REFIID](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-oaut/bbde795f-5398-42d8-9f59-3613da03c318) (或 GUID)，請使用 [\_\_uuidof()](https://learn.microsoft.com/en-us/cpp/cpp/uuidof-operator?view=vs-2019) 巨集。例如，若要取得命令清單介面的 GUID，請執行下列動作：

```cpp theme={null}
__uuidof(ID3D12PipelineState)  
```

*ppPipelineState*   \_Outptr\_<br />類型：void\*\*

產生的延伸圖形管線狀態物件。

### 傳回值

類型：HRESULT

其中一個 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues)，或 **S\_RUNTIME\_COMPILATION**，表示函式已成功，但執行了著色器的執行階段重新編譯。

S\_RUNTIME\_COMPILATION 是 XBOX 專屬的傳回值。[CreateGraphicsPipelineState](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nf-d3d12-id3d12device-creategraphicspipelinestate) 或 [CreateComputePipelineState](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nf-d3d12-id3d12device-createcomputepipelinestate) 不會傳回此值。

## 備註

使用 **CreateGraphicsPipelineStateX** 為晶片外鑲嵌建立圖形管線狀態物件。若要初始化 [D3D12XBOX\_TESSELLATION\_PARAMETERS\_DESC](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_derived_graphics_state_desc) 中的預設值，請呼叫 [D3D12XboxInitializeDefaultTessellationParameters](/zh-TW/reference/graphics/d3d12_x/functions/d3d12xboxinitializedefaulttessellationparameters)。

**CreateGraphicsPipelineStateX** 是 [CreateGraphicsPipelineState](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device-creategraphicspipelinestate) 的 XBOX 專屬版本。

## 需求

**標頭：** d3d12\_x.h

**程式庫：** d3d12\_x.lib

**支援的平台：** XBOX One 系列

## 另請參閱

[ID3D12Device](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)


## Related topics

- [CreateGraphicsPipelineState](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_creategraphicspipelinestate_public.md)
- [CreateComputePipelineState](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcomputepipelinestate_public.md)
- [CreatePipelineLibrary](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device1/methods/id3d12device1_createpipelinelibrary_public.md)
- [SetPipelineState](/zh-CN/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setpipelinestate_public.md)