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

# XGComputeTileShape (famille XBOX One)

> Retourne la forme d'une vignette de ressource en mosaïque unique pour le format spécifié.

Retourne la forme d'une vignette de ressource en mosaïque unique pour le format spécifié.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XGComputeTileShape(
         XG_RESOURCE_DIMENSION Dimension,
         XG_FORMAT Format,
         UINT32 BytesPerElement,
         UINT32 SampleCount,
         XG_TILE_SHAPE *pTileShapeInTexels,
         XG_TILE_SHAPE_ELEMENTS *pTileShapeInElements
)  
```

<a id="ID4EG" />

### Paramètres

*Dimension*   \_In\_<br />Type : [XG\_RESOURCE\_DIMENSION](/fr-CA/reference/graphics/xg__NR/enums/xg_resource_dimension)

Dimension de la ressource, sous forme de constante d'énumération [XG\_RESOURCE\_DIMENSION](/fr-CA/reference/graphics/xg__NR/enums/xg_resource_dimension), par exemple pour une ressource inconnue, une mémoire tampon, une texture 1D, une texture 2D ou une texture 3D.

*Format*   \_In\_<br />Type : [XG\_FORMAT](/fr-CA/reference/graphics/xg__NR/enums/xg_format)

Format, sous forme de constante d'énumération [XG\_FORMAT](/fr-CA/reference/graphics/xg__NR/enums/xg_format), par exemple XG\_FORMAT\_R32G32B32\_UINT.

* Si *Format* est XG\_FORMAT\_UNKNOWN, le paramètre *BytesPerElement* est utilisé à la place, et *BytesPerElement* doit être de 1, 2, 4, 8 ou 16 octets.
* Si *Format* n'est pas XG\_FORMAT\_UNKNOWN, la valeur de *BytesPerElement* est ignorée et elle est calculée par cette fonction.

*BytesPerElement*   \_In\_<br />Type : UINT32

Nombre d'octets par élément, sous forme de UINT32.

*SampleCount*   \_In\_<br />Type : UINT32

Pour toutes les dimensions de ressource autres que Texture2D, *SampleCount* doit être 1. Pour Texture2D, *SampleCount* doit être 1, 2, 4 ou 8.

*pTileShapeInTexels*   \_Out\_opt\_<br />Type : [XG\_TILE\_SHAPE\*](/fr-CA/reference/graphics/xg__NR/structs/xg_tile_shape)

Forme de la vignette, en texels, sous forme de pointeur vers une structure [XG\_TILE\_SHAPE](/fr-CA/reference/graphics/xg__NR/structs/xg_tile_shape). Si *Format* est XG\_FORMAT\_UNKNOWN, *pTileShapeInTexels* sera rempli de zéros s'il est présent.

*pTileShapeInElements*   \_Out\_opt\_<br />Type : [XG\_TILE\_SHAPE\_ELEMENTS\*](/fr-CA/reference/graphics/xg__NR/structs/xg_tile_shape_elements)

Forme de la vignette, en éléments, sous forme de pointeur vers une structure [XG\_TILE\_SHAPE\_ELEMENTS](/fr-CA/reference/graphics/xg__NR/structs/xg_tile_shape_elements).

<a id="ID4EO" />

### Valeur de retour

Type : [HRESULT](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes).

<a id="remarks" />

## Remarques

Cette fonction retourne la forme d'une vignette de ressource en mosaïque unique pour le format spécifié. La forme de la vignette est retournée en texels ainsi qu'en éléments.

<a id="requirements" />

## Configuration requise

**En-tête :** xg.h

**Bibliothèque :** xg\_x.lib

**Plateformes prises en charge :** famille XBOX One

## Voir aussi

[Référence XG](/fr-CA/reference/graphics/xg__NR/xg_members)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [D3D12_TILE_SHAPE](/reference/graphics/d3d12/structs/d3d12_tile_shape_public.md)
- [Why Sampler Feedback?](/build/core-features/graphics/newfeatures/sfs/why-sf.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [CopyTiles](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public.md)