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

# D3D12_TILE_REGION_SIZE

> Descreve o tamanho de uma região em blocos. (D3D12_TILE_REGION_SIZE)

Descreve o tamanho de uma região em blocos.

## Sintaxe

```cpp theme={null}
typedef struct D3D12_TILE_REGION_SIZE
{
    UINT NumTiles;
    BOOL UseBox;
    UINT Width;
    UINT16 Height;
    UINT16 Depth;
} D3D12_TILE_REGION_SIZE
```

### Membros

*NumTiles*\
Tipo: UINT

O número de blocos na região em blocos.

*UseBox*\
Tipo: BOOL

Especifica se o runtime usa os membros **Width**, **Height** e **Depth** para definir a região.

Se **TRUE**, o runtime usará os membros **Width**, **Height** e **Depth** para definir a região. Nesse caso, **NumTiles** deve ser igual a **Width** \*  **Height** \* **Depth**.

Se **FALSE**, o runtime ignorará os membros **Width**, **Height** e **Depth** e usará o membro **NumTiles** para percorrer os blocos no recurso linearmente ao longo de x, depois y, depois z (conforme aplicável) e, em seguida, continuará pelos mipmaps/matrizes na ordem dos sub-recursos. Por exemplo, use essa técnica para mapear um recurso inteiro de uma só vez.

Independentemente de você especificar **TRUE** ou **FALSE** para **UseBox**, você usa uma estrutura [D3D12\_TILED\_RESOURCE\_COORDINATE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public) para especificar o local inicial da região dentro do recurso como um parâmetro separado fora desta estrutura, usando as coordenadas x, y e z.

Quando a região inclui mipmaps empacotados com organização em blocos não padrão, **UseBox** deve ser **FALSE**, pois as dimensões dos blocos não são padrão e o aplicativo só sabe quantos blocos são consumidos pela área empacotada, o que é por fatia de matriz. Nesse caso, o parâmetro (separado) correspondente de local inicial usa x como deslocamento no intervalo plano de blocos, e as coordenadas y e z devem ser 0.

*Width*\
Tipo: UINT

A largura da região em blocos, em blocos. Usada para buffers e texturas 1D, 2D e 3D.

*Height*\
Tipo: UINT16

A altura da região em blocos, em blocos. Usada para texturas 2D e 3D.

*Depth*\
Tipo: UINT16

A profundidade da região em blocos, em blocos. Usada para texturas 3D ou matrizes. Para matrizes, é usada para avançar em profundidade, saltando para a próxima fatia de mesmo tamanho de mipmap, que não é contígua no espaço de contagem de sub-recursos se houver vários mipmaps.

## Comentários

Esta estrutura é usada pelos métodos [CopyTiles](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public), [CopyTileMappings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public) e [UpdateTileMappings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_updatetilemappings_public).

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

[CD3DX12\_TILE\_REGION\_SIZE](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-tile-region-size)

[Estruturas principais](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [CopyTiles](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public.md)
- [CopyTileMappings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)
- [D3D12_TILE_SHAPE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tile_shape_public.md)
- [D3D12_TILE_RANGE_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_tile_range_flags_public.md)
- [D3D12_TILE_COPY_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_tile_copy_flags_public.md)