> ## 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 (família XBOX One)

> XGEncodeDCC (consoles XBOX Series): codifica (compacta) uma superfície usando a compactação de cor delta (DCC). Referência de elementos gráficos do Direct3D 12 para XBOX.

Codifica (compacta) uma superfície usando a compactação de cor delta (DCC).

<a id="syntaxSection" />

## Sintaxe

```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" />

### Parâmetros

*DataSizeBlocks*   \_In\_<br />Tipo: UINT32

O número de blocos de 256 bytes de dados de cor especificados em *pSourceData* que devem ser compactados.

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

O endereço de um buffer que contém os dados de cor a serem compactados. O tamanho do buffer é 256 bytes multiplicado por *DataSizeBlocks*.

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

O endereço do buffer em que os dados de cor codificados (compactados) serão armazenados. O tamanho do buffer deve ser igual ao do buffer especificado em *pSourceData*: 256 bytes multiplicado por *DataSizeBlocks*. No entanto, os dados compactados podem não preencher cada bloco de 256 bytes.

*pDestKeys*   \_Out\_writes\_bytes\_(DataSizeBlocks)<br />Tipo: void\*

O endereço do buffer em que os valores de chave DCC serão armazenados: um byte por bloco compactado. O tamanho do buffer deve ser *DataSizeBlocks*.

*pDestCompressedSizes*   \_Out\_writes\_opt\_(DataSizeBlocks)<br />Tipo: UINT\*

Opcional. O endereço do buffer em que o tamanho dos dados compactados de cada bloco codificado é armazenado: um valor UINT por bloco. Se for nulo, esses valores opcionais não serão armazenados.

*Format*   \_In\_<br />Tipo: [XG\_FORMAT](/pt-BR/reference/graphics/xg__NR/enums/xg_format)

O formato de cor dos dados de cor não compactados.

*TileMode*   \_In\_<br />Tipo: [XG\_TILE\_MODE](/pt-BR/reference/graphics/xg__NR/enums/xg_tile_mode)

O modo de bloco dos dados de cor não compactados.

*pDccOptions*   \_In\_<br />Tipo: [XG\_DCC\_OPTIONS\*](/pt-BR/reference/graphics/xg__NR/structs/xg_dcc_options)

As opções de codificação DCC dos dados de cor compactados.

<a id="ID4EO" />

### Valor retornado

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

Retornará **S\_OK** se tiver êxito; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, confira [Códigos de erro](/pt-BR/reference/errorcodes).

<a id="remarks" />

## Comentários

**XGEncodeDCC** é uma implementação de um codificador DCC de software adequado para uso em ferramentas ou em compactação offline. Não é uma implementação de alto desempenho adequada ou destinada ao uso em runtime.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xg.h

**Biblioteca:** xg\_x.lib

**Plataformas com suporte:** família XBOX One

## Confira também

[Referência do XG](/pt-BR/reference/graphics/xg__NR/xg_members)<br />[XGDecodeDCC](/pt-BR/reference/graphics/xg__NR/functions/xgdecodedcc)


## Related topics

- [pre_encode_audio_stream::is_open](/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_is_open.md)
- [pre_encode_audio_stream::return_buffer](/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_return_buffer.md)
- [pre_encode_audio_stream::submit_buffer](/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_submit_buffer.md)
- [pre_encode_audio_stream::get_users](/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_get_users.md)
- [pre_encode_audio_stream::custom_stream_context](/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_custom_stream_context.md)