Skip to main content

XUserGetGamerPictureAsync

Récupère de façon asynchrone l’image du joueur d’un utilisateur donné.

Syntaxe

Paramètres

user   _In_
Type : XUserHandle
Utilisateur dont il faut récupérer l’image du joueur. pictureSize   _In_
Type : XUserGamerPictureSize
Taille de l’image du joueur à récupérer. async   _Inout_
Type : XAsyncBlock*
XAsyncBlock permettant d’interroger l’état de l’appel et de récupérer les résultats de l’appel.

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 » énumère des exigences précises quant à la façon dont les noms d’utilisateur et les images d’avatar sont affichés. 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 pour récupérer l’image du joueur retournée par XUserGetGamerPictureAsync, appelez XUserGetGamerPictureResultSize. L’image du 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 du 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