> ## 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 (consoles XBOX Series)

> XGEncodeDCC (consoles XBOX Series) — Codifica (compacta) uma superfície usando DCC (Delta Color Compression). Referência de gráficos do Direct3D 12 (confira xgencodedcc_xs)

Codifica (compacta) uma superfície usando DCC (Delta Color Compression).

## Sintaxe

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

### Parâmetros

*DataSizeBlocks*   \_In\_\
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)\
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)\
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)\
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)\
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\_\
Tipo: [XG\_FORMAT](/pt-BR/reference/graphics/xg__NR/enums/xg_format)

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

*SwizzleMode*   \_In\_\
Tipo: [XG\_SWIZZLE\_MODE](/pt-BR/reference/graphics/xg_xs/enums/xg_swizzle_mode)

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

*Dimension*   \_In\_\
Tipo: [XG\_RESOURCE\_DIMENSION](/pt-BR/reference/graphics/xg__NR/enums/xg_resource_dimension)

A dimensão de recurso dos dados de cor.

*pDccOptions*   \_In\_\
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.

### Valor retornado

Tipo: HRESULT

Retorna S\_OK se tiver êxito; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, confira [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## 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 durante o runtime.

## Requisitos

**Cabeçalho:** xg\_xs.h

**Biblioteca:** xg\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[xg\_xs](/pt-BR/reference/graphics/xg_xs/xg_xs_members)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Barrier (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist7/methods/id3d12graphicscommandlist7_barrier_public.md)
- [RemoveDevice (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_removedevice_public.md)
- [DispatchRays (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_dispatchrays_public.md)
- [CreateHeap1 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createheap1_public.md)