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

# CopyTileMappings

> Copia mapeamentos de um recurso reservado de origem para um recurso reservado de destino.

Copia mapeamentos de um recurso reservado de origem para um recurso reservado de destino.

## Sintaxe

```cpp theme={null}
void CopyTileMappings(
    ID3D12Resource  pDstResource,
    const D3D12_TILED_RESOURCE_COORDINATE  pDstRegionStartCoordinate,
    ID3D12Resource  pSrcResource,
    const D3D12_TILED_RESOURCE_COORDINATE  pSrcRegionStartCoordinate,
    const D3D12_TILE_REGION_SIZE  pRegionSize,
    D3D12_TILE_MAPPING_FLAGS Flags
)
```

### Parâmetros

*pDstResource \[in]*\
Tipo: ID3D12Resource \*

Um ponteiro para o recurso reservado de destino.

*pDstRegionStartCoordinate \[in]*\
Tipo: const D3D12\_TILED\_RESOURCE\_COORDINATE \*

Um ponteiro para uma estrutura
[D3D12\_TILED\_RESOURCE\_COORDINATE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public) que descreve as coordenadas iniciais do recurso reservado de destino.

*pSrcResource \[in]*\
Tipo: ID3D12Resource \*

Um ponteiro para o recurso reservado de origem.

*pSrcRegionStartCoordinate \[in]*\
Tipo: const D3D12\_TILED\_RESOURCE\_COORDINATE \*

Um ponteiro para uma estrutura [D3D12\_TILED\_RESOURCE\_COORDINATE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public) que descreve as coordenadas iniciais do recurso reservado de origem.

*pRegionSize \[in]*\
Tipo: const D3D12\_TILE\_REGION\_SIZE \*

Um ponteiro para uma estrutura [D3D12\_TILE\_REGION\_SIZE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tile_region_size_public) que descreve o tamanho da região reservada.

*Flags*\
Tipo: D3D12\_TILE\_MAPPING\_FLAGS

Um membro de [D3D12\_TILE\_MAPPING\_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_tile_mapping_flags_public).

### Valor retornado

Tipo: void

Nenhum.

## Comentários

Use **CopyTileMappings** para copiar os mapeamentos de blocos de um recurso reservado para outro, seja para duplicar um mapeamento de recurso ou para inicializar um novo mapeamento antes de modificá-lo usando [UpdateTileMappings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_updatetilemappings_public).

**CopyTileMappings** ajuda em tarefas como deslocar mapeamentos dentro e entre recursos reservados, por exemplo, rolar blocos.
As regiões de origem e de destino podem se sobrepor; o resultado da cópia nessa situação é como se a origem tivesse sido salva em um local temporário
e, de lá, gravada no destino.

As regiões de destino e de origem devem caber inteiramente em seus respectivos recursos; caso contrário, o comportamento será indefinido e a camada de depuração emitirá um erro.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12CommandQueue](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs)

[UpdateTileMappings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_updatetilemappings_public)

[Recursos lado a lado de volume](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/volume-tiled-resources)


## Related topics

- [D3D12_TILE_MAPPING_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_tile_mapping_flags_public.md)
- [D3D12_TILE_REGION_SIZE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tile_region_size_public.md)
- [D3D12_TILED_RESOURCE_COORDINATE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public.md)
- [CreateReservedResource1 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createreservedresource1_public.md)
- [CreateReservedResource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public.md)