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*
Le texte d’invite affiché. selectFromPlayersCount _In_
Type : uint32_t
Le 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
Le nombre de joueurs présélectionnés lorsque l’interface utilisateur est présentée. preSelectedPlayers _In_reads_opt_(preSelectedPlayersCount)
Type : uint64_t*
Pointeur vers une liste d’ID de joueurs présélectionnés lorsque l’interface utilisateur est présentée. minSelectionCount _In_
Type : uint32_t
Le nombre minimal de personnes que l’appelant doit sélectionner. maxSelectionCount _In_
Type : uint32_t
Le 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 de l’AsyncBlock ou une fois l’AsyncBlock terminé.

Remarques

Les ID de joueurs doivent être des ID d’utilisateur XBOX (XUID), qui sont une valeur uint64_t. L’appel d’une interface utilisateur fera passer votre jeu en mode limité. En mode limité, votre titre recevra moins de ressources système pendant qu’il se trouve en arrière-plan de l’interface utilisateur appelée. Pour en savoir plus sur le mode limité 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