> ## 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-CA/reference/system/xasync/structs/xasyncblock)

Pointeur vers le [XAsyncBlock](/fr-CA/reference/system/xasync/structs/xasyncblock) qui est passé à [XAsyncRun](/fr-CA/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\*

Le texte d'invite affiché.

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

Le 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

Le nombre de joueurs présélectionnés lorsque l'interface utilisateur est présentée.

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

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

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


## Related topics

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