> ## 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

Exibe uma interface do usuário de seleção que permite que uma pessoa que está jogando selecione jogadores de uma lista de pessoas apresentada.

## Sintaxe

```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  
)  
```

### Parâmetros

*async*   \_In\_\
Tipo: [XAsyncBlock\*](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md)

Um ponteiro para o [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) que é passado para [XAsyncRun](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasyncrun.md).

*requestingUser*   \_In\_\
Tipo: XUserHandle

Um identificador para o usuário que está solicitando a interface do usuário de seleção de jogadores.

*promptText*   \_In\_z\_\
Tipo: char\*

O texto de prompt exibido.

*selectFromPlayersCount*   \_In\_\
Tipo: uint32\_t

O número de jogadores entre os quais o chamador pode selecionar.

*selectFromPlayers*   \_In\_reads\_(selectFromPlayersCount)\
Tipo: uint64\_t\*

Um ponteiro para uma lista de IDs de jogadores entre os quais o chamador pode selecionar.

*preSelectedPlayersCount*   \_In\_\
Tipo: uint32\_t

O número de jogadores pré-selecionados quando a interface do usuário é apresentada.

*preSelectedPlayers*   \_In\_reads\_opt\_(preSelectedPlayersCount)\
Tipo: uint64\_t\*

Um ponteiro para uma lista de IDs de jogadores pré-selecionados quando a interface do usuário é apresentada.

*minSelectionCount*   \_In\_\
Tipo: uint32\_t

O número mínimo de pessoas que o chamador deve selecionar.

*maxSelectionCount*   \_In\_\
Tipo: uint32\_t

O número máximo de pessoas que o chamador pode selecionar.

### Valor retornado

Tipo: HRESULT

Código de êxito ou de erro HRESULT da chamada assíncrona.

Para obter o resultado, chame [XGameUiShowPlayerPickerResultCount](https://docs.xbox.com/pt-BR/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount.md) e [XGameUiShowPlayerPickerResult](https://docs.xbox.com/pt-BR/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md) dentro do retorno de chamada do *AsyncBlock* ou após a conclusão do *AsyncBlock*.

## Comentários

Os IDs de jogador devem ser IDs de usuário do XBOX (XUIDs), que são um valor *uint64\_t*.

Solicitar uma interface do usuário fará com que seu jogo entre no *modo restrito*. No modo restrito, seu título receberá menos recursos do sistema enquanto estiver em segundo plano em relação à interface do usuário solicitada. Para saber mais sobre o modo restrito e outros modos operacionais do seu título, leia [Ciclo de vida do jogo XBOX (tópico sob NDA)](https://docs.xbox.com/pt-BR/build/console-features/console-workflows/xbox-game-life-cycle.md).

## Requisitos

**Cabeçalho:** XGameUI.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

## Confira também

[XGameUI](https://docs.xbox.com/pt-BR/reference/system/xgameui/xgameui_members.md)\
[XGameUiShowPlayerPickerResult](https://docs.xbox.com/pt-BR/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md)\
[XGameUiShowPlayerPickerResultCount](https://docs.xbox.com/pt-BR/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount.md)\
[Ciclo de vida do jogo XBOX (tópico sob NDA)](https://docs.xbox.com/pt-BR/build/console-features/console-workflows/xbox-game-life-cycle.md)


## Related topics

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