Skip to main content
Retourne la forme d’une vignette de ressource en mosaïque unique pour le format spécifié.

Syntaxe

Paramètres

Dimension _In_
Type : XG_RESOURCE_DIMENSION
Dimension de la ressource, sous forme de constante d’énumération 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_
Type : XG_FORMAT
Format, sous forme de constante d’énumération 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_
Type : UINT32
Nombre d’octets par élément, sous forme de UINT32. SampleCount _In_
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_
Type : XG_TILE_SHAPE*
Forme de la vignette, en texels, sous forme de pointeur vers une structure XG_TILE_SHAPE. Si Format est XG_FORMAT_UNKNOWN, pTileShapeInTexels sera rempli de zéros s’il est présent. pTileShapeInElements _Out_opt_
Type : XG_TILE_SHAPE_ELEMENTS*
Forme de la vignette, en éléments, sous forme de pointeur vers une structure XG_TILE_SHAPE_ELEMENTS.

Valeur de retour

Type : HRESULT 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.

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.

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
Last modified on October 6, 2026