> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameUiShowPlayerPickerAsync

> XGameUiShowPlayerPickerAsync

# 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

```cpp theme={null}
HRESULT XGameUiShowPlayerPickerAsync(  
         XAsyncBlock* async,  
         XUserHandle requestingUser,  
         const char* promptText,  
         uint32_t selectFromPlayersCount,  
         const uint64_t* selectFromPlayers,  
         uint32_t preSelectedPlayersCount,  
         const uint64_t* preSelectedPlayers,  
         uint32_t minSelectionCount,  
         uint32_t maxSelectionCount  
)  
```

### Paramètres

*async*   \_In\_<br />Type : [XAsyncBlock\*](/fr/reference/system/xasync/structs/xasyncblock)

Pointeur vers le [XAsyncBlock](/fr/reference/system/xasync/structs/xasyncblock) qui est passé à [XAsyncRun](/fr/reference/system/xasync/functions/xasyncrun).

*requestingUser*   \_In\_<br />Type : XUserHandle

Handle de l'utilisateur qui demande l'interface utilisateur de sélection de joueurs.

*promptText*   \_In\_z\_<br />Type : char\*

Texte d'invite affiché.

*selectFromPlayersCount*   \_In\_<br />Type : uint32\_t

Nombre de joueurs parmi lesquels l'appelant peut effectuer une sélection.

*selectFromPlayers*   \_In\_reads\_(selectFromPlayersCount)<br />Type : uint64\_t\*

Pointeur vers une liste d'ID de joueurs parmi lesquels l'appelant peut effectuer une sélection.

*preSelectedPlayersCount*   \_In\_<br />Type : uint32\_t

Nombre de joueurs présélectionnés lors de l'affichage de l'interface utilisateur.

*preSelectedPlayers*   \_In\_reads\_opt\_(preSelectedPlayersCount)<br />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\_<br />Type : uint32\_t

Nombre minimal de personnes que l'appelant doit sélectionner.

*maxSelectionCount*   \_In\_<br />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](/fr/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount) et [XGameUiShowPlayerPickerResult](/fr/reference/system/xgameui/functions/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)](/fr/build/console-features/console-workflows/xbox-game-life-cycle).

## 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](/fr/reference/system/xgameui/xgameui_members)<br />[XGameUiShowPlayerPickerResult](/fr/reference/system/xgameui/functions/xgameuishowplayerpickerresult)<br />[XGameUiShowPlayerPickerResultCount](/fr/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount)<br />[Cycle de vie des jeux XBOX (rubrique sous NDA)](/fr/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

- [XGameUiShowPlayerPickerAsync](/reference/system/xgameui/functions/xgameuishowplayerpickerasync.md)
- [XGameUiShowPlayerPickerResult](/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md)