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

# XBTCCompressBuffer

> 壓縮包含任意資料的緩衝區，並將其附加至封存。

壓縮包含任意資料的緩衝區，並將其附加至封存。

## 語法

```cpp theme={null}
HRESULT XBTCCompressBuffer(  
         XBTCArchiveWriter* pArchive,  
         XBTC_COMPRESSION_STATS* pStats,  
         const XBTCTextureContainer* pBufferContainer,  
         XBTC_COMPRESSION_FLAGS Flags  
)  
```

### 參數

*pArchive*   \_Inout\_\
類型：[XBTCArchiveWriter](/zh-TW/reference/graphics/xbtc/interfaces/XBTCArchiveWriter/xbtcarchivewriter)\*

要附加壓縮緩衝區的目的地封存。

*pStats*   \_Out\_opt\_\
類型：[XBTC\_COMPRESSION\_STATS](/zh-TW/reference/graphics/xbtc/structs/xbtc_compression_stats)\*

傳回的壓縮大小與壓縮比資訊。

*pBufferContainer*   \_In\_\
類型：[XBTCTextureContainer](/zh-TW/reference/graphics/xbtc/interfaces/XBTCTextureContainer/xbtctexturecontainer)\*

使用者提供的未壓縮緩衝區資料。使用 [XBTCCreateBuffer](/zh-TW/reference/graphics/xbtc/functions/xbtccreatebuffer) 為資料串流配置容器。

*Flags*   \_In\_\
類型：[XBTC\_COMPRESSION\_FLAGS](/zh-TW/reference/graphics/xbtc/enums/xbtc_compression_flags)

壓縮選項。

### 傳回值

類型：HRESULT

可能的傳回值包括 S\_OK 和 E\_INVALIDARG。

## 備註

無法壓縮的緩衝區會傳回 S\_OK。如果 pStats->CompressedSize \< pStats->UncompressedSize，表示緩衝區已壓縮。

緩衝區只會套用 Deflate 壓縮。

可以在 *Flags* 中指定 XBTC\_COMPRESSION\_DISABLE\_ALL 以完全停用壓縮，以便在封存中插入使用者可讀取的中繼資料。

如需 XBTC 封存的詳細資訊，請參閱 [XBOX Texture Compressor (XBTC)](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/newfeatures/xbtc/xbox-texture-compressor)。\
如需 XBTC 成員的詳細資訊，請參閱 [XBTC 成員](/zh-TW/reference/graphics/xbtc/xbtc_members)。

## 需求

**標頭:** XBTC.h

**支援的平台**: XBOX One 系列主機與 XBOX Series 主機

## 另請參閱

[XBTC](/zh-TW/reference/graphics/xbtc/xbtc_members)


## Related topics

- [Overview of SHAPE](/build/console-features/audio/overviews/shape-overview.md)
- [HCHttpCallResponseSetGzipCompressed](/reference/live/httpclient/httpclient/functions/hchttpcallresponsesetgzipcompressed.md)
- [XBOX Texture Compressor (XBTC) tool reference](/build/core-features/graphics/newfeatures/xbtc/index.md)
- [XBOX Texture Compressor (XBTC) 도구 참고서](/ko/build/core-features/graphics/newfeatures/xbtc/index.md)
- [XBOX Texture Compressor (XBTC) 工具参考](/zh-CN/build/core-features/graphics/newfeatures/xbtc/index.md)