> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\_\
Type : [XAsyncBlock\*](https://docs.xbox.com/fr/reference/system/xasync/structs/xasyncblock.md)

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

*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](https://docs.xbox.com/fr/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount.md) et [XGameUiShowPlayerPickerResult](https://docs.xbox.com/fr/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md) 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)](https://docs.xbox.com/fr/build/console-features/console-workflows/xbox-game-life-cycle.md).

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


## Related topics

- [XGameUiShowPlayerPickerResult](https://docs.xbox.com/fr/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md)
- [XGameUiShowPlayerPickerUiCallback](https://docs.xbox.com/fr/reference/system/xgameui/functions/xgameuishowplayerpickeruicallback.md)
- [XGameUiShowPlayerPickerResultCount](https://docs.xbox.com/fr/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount.md)
- [XGameUiSetPlayerPickerUiResponse](https://docs.xbox.com/fr/reference/system/xgameui/functions/xgameuisetplayerpickeruiresponse.md)
- [XGameUiUiCallbacks](https://docs.xbox.com/fr/reference/system/xgameui/structs/xgameuiuicallbacks.md)