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

# CreateShaderCacheSession (XBOX Series 主機)

> 建立可存取著色器快取的物件，可能會開啟現有的快取或建立新的快取。

建立可存取著色器快取的物件，可能會開啟現有的快取或建立新的快取。

## 語法

```cpp theme={null}
HRESULT CreateShaderCacheSession(
    const D3D12_SHADER_CACHE_SESSION_DESC  pDesc,
    const IID & riid,
    void  ppvSession
)
```

### 參數

*pDesc*<br />類型：const D3D12\_SHADER\_CACHE\_SESSION\_DESC \*

描述要建立之著色器快取工作階段的 **D3D12\_SHADER\_CACHE\_SESSION\_DESC** 結構。

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

著色器快取工作階段介面的全域唯一識別碼 (GUID)。

*ppvSession*<br />類型：void \*\*

指向記憶體區塊的指標，該區塊會接收指向著色器快取工作階段之 [ID3D12ShaderCacheSession](/zh-TW/reference/graphics/d3d12/interfaces/id3d12shadercachesession/id3d12shadercachesession_public) 介面的指標。

### 傳回值

類型：HRESULT

如果函式成功，則會傳回 **S\_OK**。否則會傳回 [**HRESULT**](https://learn.microsoft.com/en-us/windows/desktop/com/structure-of-com-error-codes) [錯誤碼](https://learn.microsoft.com/en-us/windows/win32/com/com-error-codes-10)。

| 傳回值 | 描述 |
| - | - |
| DXGI\_ERROR\_ALREADY\_EXISTS | 您嘗試使用現有的識別碼建立快取。請參閱 [D3D12\_SHADER\_CACHE\_SESSION\_DESC::Identifier](/zh-TW/reference/graphics/d3d12/structs/d3d12_shader_cache_session_desc_public)。 |

## 備註

## 需求

**標頭:** d3d12\_xs.h<br />**程式庫:** d3d12\_xs.lib<br />**支援的平台**: XBOX Series 主機

## 另請參閱

* [D3D12 著色器快取 API](https://microsoft.github.io/DirectX-Specs/d3d/ShaderCache.html)


## Related topics

- [D3D12_SHADER_CACHE_KIND_FLAGS (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/enums/d3d12_shader_cache_kind_flags_public.md)
- [ShaderCacheControl (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device9/methods/id3d12device9_shadercachecontrol_public.md)
- [D3D12_SHADER_CACHE_CONTROL_FLAGS (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/enums/d3d12_shader_cache_control_flags_public.md)
- [CreateProtectedResourceSession (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createprotectedresourcesession_public.md)
- [D3D12_SHADER_CACHE_SESSION_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_shader_cache_session_desc_public.md)