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 SeriesVoir aussi
XGameUIXGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
Cycle de vie des jeux XBOX (rubrique sous NDA)
