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

# XGComputeOptimalDepthStencilSwizzleMode

> 計算指定深度樣板設定的正確 Swizzle 模式。

計算指定深度樣板設定的正確 Swizzle 模式。

此 API 已被取代；請改用 [XGSuggestSwizzleMode](/zh-TW/reference/graphics/xg_xs/functions/xgsuggestswizzlemode)。

## 語法

```cpp theme={null}
VOID XGComputeOptimalDepthStencilSwizzleMode(  
         XG_FORMAT Format,  
         UINT32 Width,  
         UINT32 Height,  
         UINT32 DepthOrArraySize,  
         UINT32 SampleCount,  
         BOOL Compressed,  
         BOOL TiledResource,  
         BOOL TextureCompatible,  
         XG_SWIZZLE_MODE* pDepthSwizzleMode  
)  
```

### 參數

*Format*   \_In\_\
類型：[XG\_FORMAT](/zh-TW/reference/graphics/xg__NR/enums/xg_format)

格式，以 [XG\_FORMAT](/zh-TW/reference/graphics/xg__NR/enums/xg_format) 列舉常數表示。

*Width*   \_In\_\
類型：UINT32

寬度 (以像素為單位)。

*Height*   \_In\_\
類型：UINT32

高度 (以像素為單位)。

*DepthOrArraySize*   \_In\_\
類型：UINT32

深度或陣列大小。

*SampleCount*   \_In\_\
類型：UINT32

要使用的取樣數。

*Compressed*   \_In\_\
類型：BOOL

未使用此參數；在所有情況下都傳遞 `TRUE`。

*TiledResource*   \_In\_\
類型：BOOL

如果使用此並排模式的深度紋理將搭配 Direct3D 並排資源功能 (也稱為部分常駐紋理) 使用，則為 `TRUE`。如果此參數為 `TRUE`，則不支援樣板。

*TextureCompatible*   \_In\_\
類型：BOOL

如果使用此 Swizzle 模式的深度紋理將在壓縮狀態下作為紋理取樣，則為 `TRUE`。如果此參數為 `TRUE`，則不支援樣板。

*pDepthSwizzleMode*   \_Out\_\
類型：[XG\_SWIZZLE\_MODE](/zh-TW/reference/graphics/xg_xs/enums/xg_swizzle_mode)

輸出的深度 Swizzle 模式，以指向 [XG\_SWIZZLE\_MODE](/zh-TW/reference/graphics/xg_xs/enums/xg_swizzle_mode) 列舉常數的指標表示。

### 傳回值

無。

## 備註

此函式一律會輸出 XG\_SWIZZLE\_MODE\_64KB\_Z\_X，因為這是 XBOX Series X|S 硬體上唯一支援的深度 Swizzle 模式。

## 需求

**標頭：** xg\_xs.h

**程式庫：** xg\_xs.lib\
**支援的平台**：XBOX Series 主機

## 另請參閱

[xg\_xs](/zh-TW/reference/graphics/xg_xs/xg_xs_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [DSTORAGE_SWIZZLE_MODE](/zh-TW/reference/system/dstorage/enums/dstorage_swizzle_mode.md)
- [D3D12_DEPTH_STENCIL_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc_public.md)
- [CreateDepthStencilView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdepthstencilview_public.md)
- [D3D12_DEPTH_STENCIL_DESC1](/zh-TW/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc1_public.md)