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

# DeserializeGraphicsPipelineStateX (XBOX One 系列)

> 將先前序列化的圖形管線狀態物件還原序列化，以便在執行階段有效率地載入管線狀態物件。

將先前序列化的圖形管線狀態物件還原序列化，以便在執行階段有效率地載入管線狀態物件。

## 語法

```cpp theme={null}
HRESULT DeserializeGraphicsPipelineStateX(  
         const D3D12XBOX_DESERIALIZE_GRAPHICS_PIPELINE_STATE* pDeserializeState,  
         REFIID riid,  
         void** ppPipelineState  
)  
```

### 參數

*pDeserializeState*   \_In\_<br />類型：[D3D12XBOX\_DESERIALIZE\_GRAPHICS\_PIPELINE\_STATE\*](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_deserialize_graphics_pipeline_state)

還原序列化狀態，以指向 D3D12XBOX\_DESERIALIZE\_GRAPHICS\_PIPELINE\_STATE 結構的指標表示。

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

管線狀態介面 [ID3D12PipelineState](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12pipelinestate/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)。

## 備註

如需使用方式資訊，請參閱 [ID3D12Device::SerializeGraphicsPipelineStateX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_serializegraphicspipelinestatex)。

**DeserializeGraphicsPipelineStateX** 絕不會在執行階段叫用著色器的編譯，即使著色器原本是使用比目前 Direct3D 執行階段更舊的著色器編譯器建置也是如此。換句話說，序列化的管線狀態物件不受著色器編譯器更新的影響。不過，當開發移至較新的 XBOX One 軟體開發套件版本時，Direct3D 12.x 可能會拒絕載入使用較舊 XDK 建置的序列化管線狀態物件；在此情況下，**DeserializeGraphicsPipelineStateX** 會傳回錯誤，因此必須重新建置並重新序列化所有這類管線狀態物件。儘管如此，我們預期這類重大變更將非常罕見，例如會比著色器編譯器格式的變更更罕見。

## 需求

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

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

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

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

## 另請參閱

[ID3D12Device](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)<br />[SerializeGraphicsPipelineStateX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_serializegraphicspipelinestatex)


## Related topics

- [CreateGraphicsPipelineState](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_creategraphicspipelinestate_public.md)
- [SetPipelineState](/zh-CN/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setpipelinestate_public.md)
- [CreateComputePipelineState](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createcomputepipelinestate_public.md)
- [D3D12_CACHED_PIPELINE_STATE](/zh-CN/reference/graphics/d3d12/structs/d3d12_cached_pipeline_state_public.md)
- [D3D12_COMPUTE_PIPELINE_STATE_DESC](/zh-CN/reference/graphics/d3d12/structs/d3d12_compute_pipeline_state_desc_public.md)