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

> Compacta um buffer com dados arbitrários e o acrescenta ao arquivo.

Compacta um buffer com dados arbitrários e o acrescenta ao arquivo.

## Sintaxe

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

### Parâmetros

*pArchive*   \_Inout\_\
Tipo: [XBTCArchiveWriter](/pt-BR/reference/graphics/xbtc/interfaces/XBTCArchiveWriter/xbtcarchivewriter)\*

Arquivo de destino ao qual o buffer compactado será acrescentado.

*pStats*   \_Out\_opt\_\
Tipo: [XBTC\_COMPRESSION\_STATS](/pt-BR/reference/graphics/xbtc/structs/xbtc_compression_stats)\*

Informações retornadas sobre o tamanho compactado e a taxa de compactação.

*pBufferContainer*   \_In\_\
Tipo: [XBTCTextureContainer](/pt-BR/reference/graphics/xbtc/interfaces/XBTCTextureContainer/xbtctexturecontainer)\*

Os dados do buffer não compactados fornecidos pelo usuário.  Use [XBTCCreateBuffer](/pt-BR/reference/graphics/xbtc/functions/xbtccreatebuffer) para alocar um contêiner para o fluxo de dados.

*Flags*   \_In\_\
Tipo: [XBTC\_COMPRESSION\_FLAGS](/pt-BR/reference/graphics/xbtc/enums/xbtc_compression_flags)

Opções de compactação.

### Valor retornado

Tipo: HRESULT

Os valores retornados possíveis incluem S\_OK e E\_INVALIDARG.

## Comentários

Um buffer incompactável retornará S\_OK. O buffer foi compactado se pStats->CompressedSize \< pStats->UncompressedSize.

Somente a compactação Deflate é aplicada a buffers.

É possível desabilitar completamente a compactação especificando XBTC\_COMPRESSION\_DISABLE\_ALL em *Flags* para inserir metadados legíveis pelo usuário no arquivo.

Para obter mais informações sobre arquivos XBTC, confira [XBOX Texture Compressor (XBTC)](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/newfeatures/xbtc/xbox-texture-compressor).\
Para obter mais informações sobre os membros do XBTC, confira [Membros do XBTC](/pt-BR/reference/graphics/xbtc/xbtc_members).

## Requisitos

**Cabeçalho:** XBTC.h

**Plataformas com suporte**: consoles da família XBOX One e consoles XBOX Series

## Confira também

[XBTC](/pt-BR/reference/graphics/xbtc/xbtc_members)


## Related topics

- [Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview.md)
- [HCHttpCallResponseSetGzipCompressed](/pt-BR/reference/live/httpclient/httpclient/functions/hchttpcallresponsesetgzipcompressed.md)
- [Referência da ferramenta XBOX Texture Compressor (XBTC)](/pt-BR/build/core-features/graphics/newfeatures/xbtc/index.md)
- [HCCompressionLevel](/pt-BR/reference/live/httpclient/httpclient/enums/hccompressionlevel.md)
- [SHAPE_EQCOMP_COMPRESSOR_MODE](/pt-BR/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_compressor_mode.md)