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

# XGSuggestSwizzleMode (XBOX Series 主機)

> 計算指定資源描述的正確 Swizzle 模式。

計算指定資源描述的正確 Swizzle 模式，並使用旗標來指定所需的效能/記憶體使用量取捨。

## 語法

```cpp theme={null}
HRESULT XGSuggestSwizzleMode(
    const XG_RESOURCE_DESC* pResourceDesc,
    XG_SUGGEST_SWIZZLE_MODE_FLAGS Flags,
    XG_TEXTURE_LAYOUT* pTextureLayout
)
```

### 參數

*pResourceDesc*   \_In\_\
類型：const [XG\_RESOURCE\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_resource_desc)\*

資源描述結構，以 [XG\_RESOURCE\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_resource_desc) 結構表示。

如果 pResourceDesc 參數中的 Layout 欄位包含其中一個延伸 XG\_TEXTURE\_LAYOUT\_SWIZZLE\_MODE\_\* 值，則會忽略該欄位。使用 XG\_TEXTURE\_LAYOUT\_64KB\_UNDEFINED\_SWIZZLE 的 Layout 值來表示保留/並排資源。

*Flags*   \_In\_\
類型：[XG\_SUGGEST\_SWIZZLE\_MODE\_FLAGS](/zh-TW/reference/graphics/xg_xs/enums/xg_suggest_swizzle_mode_flags)

影響 Swizzle 模式選取的旗標。

可以指定 XG\_SUGGEST\_SWIZZLE\_MODE\_FLAG\_OPTIMIZE\_FOR\_PERFORMANCE 或 XG\_SUGGEST\_SWIZZLE\_MODE\_FLAG\_OPTIMIZE\_FOR\_MEMORY\_FOOTPRINT，分別選取針對最高 GPU 效能或最小圖形記憶體使用量最佳化的 Swizzle 模式。
如果未指定針對效能最佳化，也未指定針對記憶體使用量最佳化，驅動程式的建議將會針對效能最佳化。

*pTextureLayout*   \_Out\_\
類型：[XG\_TEXTURE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/enums/xg_texture_layout)\*

驅動程式所選擇的建議 Swizzle 模式，以 XG\_TEXTURE\_LAYOUT 形式表示。
這一律會是直接指定硬體 Swizzle 模式的其中一個 XBOX 延伸值 (XG\_TEXTURE\_LAYOUT\_SWIZZLE\_MODE\_\*)。

### 傳回值

類型：HRESULT

如果成功，則傳回 S\_OK；如果任何輸入遺失或不正確，則傳回 E\_INVALIDARG。

## 需求

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

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

## 另請參閱

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


## Related topics

- [DSTORAGE_SWIZZLE_MODE](/reference/system/dstorage/enums/dstorage_swizzle_mode.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [XR130 XBOX Series X|S 世代](/zh-TW/publishing/certification/fma/xr-130.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)