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

> Describe el tamaño de una región en mosaico. (D3D12_TILE_REGION_SIZE)

Describe el tamaño de una región en mosaico.

## Sintaxis

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

### Miembros

*NumTiles*\
Tipo: UINT

El número de mosaicos de la región en mosaico.

*UseBox*\
Tipo: BOOL

Especifica si el entorno de ejecución usa los miembros **Width**, **Height** y **Depth** para definir la región.

Si es **TRUE**, el entorno de ejecución usa los miembros **Width**, **Height** y **Depth** para definir la región. En este caso, **NumTiles** debe ser igual a **Width** \* **Height** \* **Depth**.

Si es **FALSE**, el entorno de ejecución omite los miembros **Width**, **Height** y **Depth** y usa el miembro **NumTiles** para recorrer los mosaicos del recurso linealmente por x, después y y después z (según corresponda), y a continuación se desborda a los mipmaps o matrices en el orden de los subrecursos. Por ejemplo, use esta técnica para asignar un recurso completo de una vez.

Independientemente de si especifica **TRUE** o **FALSE** para **UseBox**, use una estructura [D3D12\_TILED\_RESOURCE\_COORDINATE](/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public) para especificar la ubicación inicial de la región dentro del recurso como un parámetro independiente fuera de esta estructura mediante las coordenadas x, y y z.

Cuando la región incluye mipmaps empaquetados con mosaico no estándar, **UseBox** debe ser **FALSE** porque las dimensiones de los mosaicos no son estándar y la aplicación solo conoce un recuento de cuántos mosaicos consume el área empaquetada, que es por segmento de matriz. En este caso, el parámetro de ubicación inicial (independiente) correspondiente usa x para el desplazamiento dentro del intervalo plano de mosaicos, y las coordenadas y y z deben ser 0.

*Width*\
Tipo: UINT

El ancho de la región en mosaico, en mosaicos. Se usa para búferes y texturas 1D, 2D y 3D.

*Height*\
Tipo: UINT16

El alto de la región en mosaico, en mosaicos. Se usa para texturas 2D y 3D.

*Depth*\
Tipo: UINT16

La profundidad de la región en mosaico, en mosaicos. Se usa para texturas 3D o matrices. Para las matrices, se usa para avanzar en profundidad saltando al siguiente segmento del mismo tamaño de mipmap, que no es contiguo en el espacio de recuento de subrecursos si hay varios mipmaps.

## Comentarios

Esta estructura la usan los métodos [CopyTiles](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public), [CopyTileMappings](/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public) y [UpdateTileMappings](/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_updatetilemappings_public).

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

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

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


## Related topics

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