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

# D3D12XBOX_COPY_FLAGS (família XBOX One)

> D3D12XBOX_COPY_FLAGS (consoles da família XBOX One) — Sinalizadores para controlar a cópia para a memória ou o preenchimento da memória. Referência de gráficos do Direct3D 12 para XBOX.

Sinalizadores para controlar a cópia para a memória ou o preenchimento da memória.

## Sintaxe

```cpp theme={null}
typedef enum D3D12XBOX_COPY_FLAGS  : UINT  
{  
    D3D12XBOX_COPY_FLAG_NONE = 0x0,  
    D3D12XBOX_COPY_FLAG_RESUMMARIZE_HTILE = 0x10,  
    D3D12XBOX_COPY_FLAG_FORCE_DECOMPRESS_EXPAND_COLOR = 0x20,  
    D3D12XBOX_COPY_FLAG_FORCE_DECOMPRESS_EXPAND_DEPTH = 0x20,  
    D3D12XBOX_COPY_FLAG_FORCE_DECOMPRESS_EXPAND_STENCIL = 0x40,  
    D3D12XBOX_COPY_FLAG_FORCE_DECOMPRESS = 0x60,  
    D3D12XBOX_COPY_FLAG_FORCE_PROPAGATE_COLOR_CLEAR = 0x400,  
    D3D12XBOX_COPY_FLAG_FORCE_GATHER_COLOR_FMASK = 0x800,  
    D3D12XBOX_COPY_FLAG_FORCE_ELIMINATE_DCC = 0x1000,  
    D3D12XBOX_COPY_FLAG_COPY_DEPTH_SAMPLE_TO_RED = 0x80,  
    D3D12XBOX_COPY_FLAG_COPY_STENCIL_SAMPLE_TO_RED = 0x100,  
    D3D12XBOX_COPY_FLAG_COPY_STENCIL_SAMPLE_TO_GREEN = 0x180,  
    D3D12XBOX_COPY_FLAG_COPY_DEPTH_STENCIL_SAMPLES_TO_RED_GREEN = 0x200,  
    D3D12XBOX_COPY_FLAG_INVALIDATE_HTILE = 0x400,
    D3D12XBOX_COPY_FLAG_USE_CP_DMA = 0x800
} D3D12XBOX_COPY_FLAGS  
```

## Constantes

| Constante | Descrição |
| - | - |
| D3D12XBOX\_COPY\_FLAG\_NONE | Nenhum sinalizador está definido. |
| D3D12XBOX\_COPY\_FLAG\_RESUMMARIZE\_HTILE | Use com recursos de profundidade e estêncil para forçar a GPU a resumir novamente as metainformações de HTile a partir dos dados base de profundidade e estêncil do recurso especificado. O recurso deve ter sido criado com o sinalizador D3D12XBOX\_RESOURCE\_FLAG\_DENY\_DEPTH\_COMPRESSION\_EXPCLEAR. |
| D3D12XBOX\_COPY\_FLAG\_FORCE\_DECOMPRESS\_EXPAND\_COLOR | Força a GPU a descompactar um recurso de cor (baseado em destino de renderização). |
| D3D12XBOX\_COPY\_FLAG\_FORCE\_DECOMPRESS\_EXPAND\_DEPTH | Força a GPU a descompactar um recurso de profundidade. |
| D3D12XBOX\_COPY\_FLAG\_FORCE\_DECOMPRESS\_EXPAND\_STENCIL | Força a GPU a descompactar um recurso de estêncil. |
| D3D12XBOX\_COPY\_FLAG\_FORCE\_DECOMPRESS | Força a GPU a descompactar tanto a profundidade quanto o estêncil em um recurso. |
| D3D12XBOX\_COPY\_FLAG\_FORCE\_PROPAGATE\_COLOR\_CLEAR | Força a GPU a propagar a limpeza da cor de limpeza. |
| D3D12XBOX\_COPY\_FLAG\_FORCE\_GATHER\_COLOR\_FMASK | Força a GPU a reunir os planos de bits que constituem um grupo de ponteiros de fragmento de fmask em valores de bits contíguos para cada amostrador. Isso permite que um sombreador busque no fmask e determine os índices de multiamostra a serem usados na busca das cores de fragmento para leituras de texturas compactadas. |
| D3D12XBOX\_COPY\_FLAG\_FORCE\_ELIMINATE\_DCC | Força a GPU a descompactar (eliminar) os blocos compactados com DCC de uma superfície DCC. Após a conclusão da eliminação, a superfície DCC contém apenas blocos não compactados. Isso tem suporte apenas no hardware dos consoles XBOX One X e XBOX Series. |
| D3D12XBOX\_COPY\_FLAG\_COPY\_DEPTH\_SAMPLE\_TO\_RED | Copia a amostra 0 de uma superfície de profundidade para os valores de vermelho de uma superfície de cor. |
| D3D12XBOX\_COPY\_FLAG\_COPY\_STENCIL\_SAMPLE\_TO\_RED | Copia a amostra 0 de uma superfície de estêncil para os valores de vermelho de uma superfície de cor. |
| D3D12XBOX\_COPY\_FLAG\_COPY\_STENCIL\_SAMPLE\_TO\_GREEN | Copia a amostra 0 de uma superfície de estêncil para os valores de verde de uma superfície de cor. |
| D3D12XBOX\_COPY\_FLAG\_COPY\_DEPTH\_STENCIL\_SAMPLES\_TO\_RED\_GREEN | Copia a amostra 0 de uma superfície de profundidade para os valores de vermelho de uma superfície de cor e copia a amostra 0 de uma superfície de estêncil para os valores de verde da mesma superfície de cor. |
| D3D12XBOX\_COPY\_FLAG\_INVALIDATE\_HTILE | Invalida o buffer de HTile. |
| D3D12XBOX\_COPY\_FLAG\_USE\_CP\_DMA | Usa o mecanismo de DMA do Processador de Comandos para executar a cópia em vez dos Shader Engines da GPU. Use isso para reduzir os requisitos de sincronização de dependência de dados ao executar cópias pequenas. |

## Comentários

Use esses sinalizadores para instruir o driver a copiar a amostra 0 de uma superfície de profundidade ou estêncil para uma superfície de cor, sem executar a descompactação. A cor de destino deve estar descompactada. Isso pode ser usado para uma cópia rápida da amostra 0 da profundidade e do estêncil para uma superfície de cor.

Os seguintes métodos usam esta enumeração:

* [CopyResourceX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copyresourcex)
* [CopyMemoryToMemoryX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copymemorytomemoryx)
* [FillMemoryWith32BitValueX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_fillmemorywith32bitvaluex)
* [FillMemoryWith64BitValueX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_fillmemorywith64bitvaluex)
* [FillMemoryWith128BitValueX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_fillmemorywith128bitvaluex)
* [CopyMemoryToMemoryX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12xboxdmacommandlist/methods/id3d12xboxdmacommandlist_copymemorytomemoryx)
* [FillMemoryWith32BitValueX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12xboxdmacommandlist/methods/id3d12xboxdmacommandlist_fillmemorywith32bitvaluex)

## Requisitos

**Cabeçalho:** d3d12\_x.h

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

## Confira também

[d3d12\_x](/pt-BR/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [D3D12_TILE_COPY_FLAGS](/es/reference/graphics/d3d12/enums/d3d12_tile_copy_flags_public.md)
- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
