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

# XGEncodeDCC (XBOX Series 主機)

> XGEncodeDCC (XBOX Series 主機) — 使用差異色彩壓縮 (DCC) 編碼 (壓縮) 表面。Direct3D 12 圖形參考 (請參閱 xgencodedcc_xs)

使用差異色彩壓縮 (DCC) 編碼 (壓縮) 表面。

## 語法

```cpp theme={null}
HRESULT XGEncodeDCC(  
         UINT32 DataSizeBlocks,  
         const void* pSourceData,  
         void* pDestData,  
         void* pDestKeys,  
         UINT* pDestCompressedSizes,  
         XG_FORMAT Format,  
         XG_SWIZZLE_MODE SwizzleMode,  
         XG_RESOURCE_DIMENSION Dimension,  
         const XG_DCC_OPTIONS* pDccOptions  
)  
```

### 參數

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

*pSourceData* 中指定且要壓縮之色彩資料的 256 位元組區塊數目。

*pSourceData*   \_In\_reads\_bytes\_(DataSizeBlocks*XG\_DCC\_BLOCK\_SIZE\_BYTES)\
類型：void*

包含要壓縮之色彩資料的緩衝區位址。緩衝區的大小為 256 位元組乘以 *DataSizeBlocks*。

*pDestData*   \_Out\_writes\_bytes\_(DataSizeBlocks*XG\_DCC\_BLOCK\_SIZE\_BYTES)\
類型：void*

將儲存已編碼 (已壓縮) 色彩資料的緩衝區位址。緩衝區的大小應與 *pSourceData* 中指定的緩衝區相同：256 位元組乘以 *DataSizeBlocks*。不過，壓縮的資料可能不會填滿每個 256 位元組區塊。

*pDestKeys*   \_Out\_writes\_bytes\_(DataSizeBlocks)\
類型：void\*

將儲存 DCC 索引鍵值的緩衝區位址：每個壓縮區塊一個位元組。緩衝區的大小應為 *DataSizeBlocks*。

*pDestCompressedSizes*   \_Out\_writes\_opt\_(DataSizeBlocks)\
類型：UINT\*

選擇性。儲存每個已編碼區塊之壓縮資料大小的緩衝區位址：每個區塊一個 UINT 值。如果為 null，則不會儲存這些選擇性的值。

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

未壓縮色彩資料的色彩格式。

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

未壓縮色彩資料的 Swizzle 模式。

*Dimension*   \_In\_\
類型：[XG\_RESOURCE\_DIMENSION](/zh-TW/reference/graphics/xg__NR/enums/xg_resource_dimension)

色彩資料的資源維度。

*pDccOptions*   \_In\_\
類型：[XG\_DCC\_OPTIONS\*](/zh-TW/reference/graphics/xg__NR/structs/xg_dcc_options)

壓縮色彩資料的 DCC 編碼選項。

### 傳回值

類型：HRESULT

如果成功，則傳回 S\_OK；否則傳回錯誤碼。如需錯誤碼清單，請參閱 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)。

## 備註

**XGEncodeDCC** 是軟體 DCC 編碼器的實作，適合用於工具或離線壓縮。它不是高效能實作，不適合也不打算在執行階段期間使用。

## 需求

**標頭：** 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)
- [XBOX Series X|S 總覽](/zh-TW/paths/series-xs/overview.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [Play Anywhere(主機 + PC)總覽](/zh-TW/paths/play-anywhere/overview.md)
- [XR-130 XBOX Series X|S 世代](/zh-TW/publishing/certification/xr/xr-130.md)