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

> Décrit la taille d'une région en mosaïque. (D3D12_TILE_REGION_SIZE)

Décrit la taille d'une région en mosaïque.

## Syntaxe

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

### Membres

*NumTiles*\
Type : UINT

Le nombre de vignettes dans la région en mosaïque.

*UseBox*\
Type : BOOL

Spécifie si le runtime utilise les membres **Width**, **Height** et **Depth** pour définir la région.

Si la valeur est **TRUE**, le runtime utilise les membres **Width**, **Height** et **Depth** pour définir la région. Dans ce cas, **NumTiles** doit être égal à **Width** \*  **Height** \* **Depth**.

Si la valeur est **FALSE**, le runtime ignore les membres **Width**, **Height** et **Depth** et utilise le membre **NumTiles** pour parcourir linéairement les vignettes de la ressource selon x, puis y, puis z (le cas échéant), puis déborde sur les mipmaps et tableaux dans l'ordre des sous-ressources. Par exemple, utilisez cette technique pour mapper une ressource entière en une seule fois.

Que vous spécifiiez **TRUE** ou **FALSE** pour **UseBox**, vous utilisez une structure [D3D12\_TILED\_RESOURCE\_COORDINATE](/fr-CA/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public) pour spécifier l'emplacement de départ de la région dans la ressource, comme paramètre distinct en dehors de cette structure, à l'aide des coordonnées x, y et z.

Lorsque la région comprend des mipmaps compactés avec un pavage non standard, **UseBox** doit être **FALSE**, car les dimensions des vignettes ne sont pas standard et l'application connaît seulement le nombre de vignettes utilisées par la zone compactée, qui est défini par tranche de tableau. Dans ce cas, le paramètre d'emplacement de départ correspondant (distinct) utilise x comme décalage dans la plage plate de vignettes, et les coordonnées y et z doivent chacune être 0.

*Width*\
Type : UINT

La largeur de la région en mosaïque, en vignettes. Utilisée pour les tampons et les textures 1D, 2D et 3D.

*Height*\
Type : UINT16

La hauteur de la région en mosaïque, en vignettes. Utilisée pour les textures 2D et 3D.

*Depth*\
Type : UINT16

La profondeur de la région en mosaïque, en vignettes. Utilisée pour les textures 3D ou les tableaux. Pour les tableaux, l'avancement en profondeur passe à la tranche suivante de même taille de mipmap, qui n'est pas contiguë dans l'espace de numérotation des sous-ressources s'il y a plusieurs mipmaps.

## Remarques

Cette structure est utilisée par les méthodes [CopyTiles](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public), [CopyTileMappings](/fr-CA/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public) et [UpdateTileMappings](/fr-CA/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_updatetilemappings_public).

## Configuration requise

**En-tête :** d3d12\_xs.h ou d3d12\_x.h\
**Bibliothèque :** d3d12\_xs.lib ou d3d12\_x.lib\
**Plateformes prises en charge :** consoles XBOX Series et famille XBOX One

## Voir aussi

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

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


## Related topics

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