Skip to main content

XGameUiShowPlayerPickerAsync

Affiche une interface utilisateur de sélection qui permet à une personne qui joue au jeu de sélectionner des joueurs dans une liste de personnes présentée.

Syntaxe

Paramètres

async _In_
Type : XAsyncBlock*
Pointeur vers le XAsyncBlock qui est passé à XAsyncRun. requestingUser _In_
Type : XUserHandle
Handle de l’utilisateur qui demande l’interface utilisateur de sélection de joueurs. promptText _In_z_
Type : char*
Texte d’invite affiché. selectFromPlayersCount _In_
Type : uint32_t
Nombre de joueurs parmi lesquels l’appelant peut effectuer une sélection. selectFromPlayers _In_reads_(selectFromPlayersCount)
Type : uint64_t*
Pointeur vers une liste d’ID de joueurs parmi lesquels l’appelant peut effectuer une sélection. preSelectedPlayersCount _In_
Type : uint32_t
Nombre de joueurs présélectionnés lors de l’affichage de l’interface utilisateur. preSelectedPlayers _In_reads_opt_(preSelectedPlayersCount)
Type : uint64_t*
Pointeur vers une liste d’ID de joueurs présélectionnés lors de l’affichage de l’interface utilisateur. minSelectionCount _In_
Type : uint32_t
Nombre minimal de personnes que l’appelant doit sélectionner. maxSelectionCount _In_
Type : uint32_t
Nombre maximal de personnes que l’appelant peut sélectionner.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT de l’appel asynchrone. Pour obtenir le résultat, appelez XGameUiShowPlayerPickerResultCount et XGameUiShowPlayerPickerResult dans le rappel AsyncBlock ou une fois l’AsyncBlock terminé.

Remarques

Les ID de joueurs doivent être des ID d’utilisateur XBOX (XUID), qui sont des valeurs uint64_t. L’appel d’une interface utilisateur fait passer votre jeu en mode contraint. En mode contraint, votre titre reçoit moins de ressources système lorsqu’il se trouve en arrière-plan de l’interface utilisateur appelée. Pour en savoir plus sur le mode contraint et les autres modes de fonctionnement de votre titre, consultez Cycle de vie des jeux XBOX (rubrique sous NDA).

Configuration requise

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

Voir aussi

XGameUI
XGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
Cycle de vie des jeux XBOX (rubrique sous NDA)
Last modified on October 6, 2026