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

# XBTCBlockCompressTexture

> Cria e aloca um contêiner de textura para uma textura linear e aplica compactação em blocos a ela.

Cria e aloca um contêiner de textura para uma textura linear e aplica compactação em blocos a ela.

## Sintaxe

```cpp theme={null}
HRESULT XBTCBlockCompressTexture(  
         XBTCTextureContainer** ppBCTexture,  
         const XBTCTextureContainer* pSourceTexture,  
         DXGI_FORMAT BlockCompressFormat,  
         XBTC_ENCODING_OPTIONS Options= XBTC_DEFAULT_ENCODING_OPTIONS,  
         XBTC_ENCODING_STATS* pStats= nullptr  
)  
```

### Parâmetros

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

Um ponteiro para um endereço de um `XBTCTextureContainer`.

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

Um ponteiro para o `XBTCTextureContainer` de origem.

*BlockCompressFormat*   \_In\_\
Tipo: DXGI\_FORMAT

Formato da textura (para BCPack).

*Options*   \_In\_\
Tipo: [XBTC\_ENCODING\_OPTIONS](/pt-BR/reference/graphics/xbtc/structs/xbtc_encoding_options)

Opções de codificação da compactação.

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

No retorno, contém estatísticas de codificação da operação de compactação.

### Valor retornado

Tipo: HRESULT

Código HRESULT de êxito ou de erro.

## Comentários

`XBTCBlockCompressTexture` aplica compactação em blocos (codifica em um formato BCn) a uma textura de origem linear.
Em seguida, a função aloca uma textura linear para a saída.

## 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)\
[Visão geral do XBOX Texture Compressor](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/newfeatures/xbtc/xbox-texture-compressor)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Referência da ferramenta XBOX Texture Compressor (XBTC)](/pt-BR/build/core-features/graphics/newfeatures/xbtc/index.md)
- [D3D12_TEXTURE_COPY_LOCATION](/pt-BR/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public.md)
- [D3D12_TEXTURE_COPY_TYPE](/pt-BR/reference/graphics/d3d12/enums/d3d12_texture_copy_type_public.md)
- [D3D12_TEXTURE_BARRIER (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_texture_barrier_public.md)