Skip to main content

XUserGetGamerPictureAsync

Récupère de manière asynchrone l’image de joueur d’un utilisateur spécifique.

Syntaxe

Paramètres

user   _In_
Type : XUserHandle
Utilisateur dont l’image de joueur doit être récupérée. pictureSize   _In_
Type : XUserGamerPictureSize
Taille de l’image de joueur à récupérer. async   _Inout_
Type : XAsyncBlock*
XAsyncBlock permettant d’interroger l’état de l’appel et de récupérer ses résultats.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.
Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

Le XR « Display Name and Gamerpic » répertorie des exigences spécifiques concernant l’affichage des noms d’utilisateur et des images d’avatar. Pour plus de détails, consultez les exigences XBOX pour les jeux et applications hub XBOX One (XBOX Developer Downloads->Partner, Publishing, and Release Management Information->XGD Partner Documentation). Pour récupérer le résultat d’un appel à XUserGetGamerPictureAsync, appelez XUserGetGamerPictureResult. Pour récupérer la taille de mémoire tampon requise par XUserGetGamerPictureResult afin de récupérer l’image de joueur retournée par XUserGetGamerPictureAsync, appelez XUserGetGamerPictureResultSize. L’image de joueur retournée est une image au format .PNG. La taille de l’image peut atteindre 2^32 octets. L’exemple suivant montre comment charger une image de joueur.

Configuration requise

En-tête : XUser.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XUser XUserGetGamerPictureResult XUserGetGamerPictureResultSize
Last modified on October 6, 2026