> ## 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 One 系列)

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

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

<a id="syntaxSection" />

## 語法

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

<a id="ID4EG" />

### 參數

*DataSizeBlocks*   \_In\_<br />類型：UINT32

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

*pSourceData*   \_In\_reads\_bytes\_(DataSizeBlocks\_XG\_DCC\_BLOCK\_SIZE\_BYTES)\_<br />*類型：void*

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

*pDestData*   \_Out\_writes\_bytes\_(DataSizeBlocks\_XG\_DCC\_BLOCK\_SIZE\_BYTES)\_<br />*類型：void*

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

*pDestKeys*   \_Out\_writes\_bytes\_(DataSizeBlocks)<br />類型：void\*

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

*pDestCompressedSizes*   \_Out\_writes\_opt\_(DataSizeBlocks)<br />類型：UINT\*

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

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

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

*TileMode*   \_In\_<br />類型：[XG\_TILE\_MODE](/zh-TW/reference/graphics/xg__NR/enums/xg_tile_mode)

未壓縮色彩資料的並排模式。

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

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

<a id="ID4EO" />

### 傳回值

類型：[HRESULT](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

如果成功，會傳回 **S\_OK**；否則會傳回錯誤碼。如需錯誤碼清單，請參閱[錯誤碼](/zh-TW/reference/errorcodes)。

<a id="remarks" />

## 備註

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

<a id="requirements" />

## 需求

**標頭：** xg.h

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

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

## 另請參閱

[XG 參考](/zh-TW/reference/graphics/xg__NR/xg_members)<br />[XGDecodeDCC](/zh-TW/reference/graphics/xg__NR/functions/xgdecodedcc)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [pre_encode_audio_stream::is_open](/zh-TW/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_is_open.md)
- [pre_encode_audio_stream::get_users](/zh-TW/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_get_users.md)
- [pre_encode_audio_stream::return_buffer](/zh-TW/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_return_buffer.md)
- [pre_encode_audio_stream::submit_buffer](/zh-TW/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_submit_buffer.md)