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

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\_<br />Tipo: [XAsyncBlock\*](/pt-BR/reference/system/xasync/structs/xasyncblock)

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

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

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

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

O texto de prompt exibido.

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

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

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

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

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

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

*preSelectedPlayers*   \_In\_reads\_opt\_(preSelectedPlayersCount)<br />Tipo: uint64\_t\*

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

*minSelectionCount*   \_In\_<br />Tipo: uint32\_t

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

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

## 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](/pt-BR/reference/system/xgameui/xgameui_members)<br />[XGameUiShowPlayerPickerResult](/pt-BR/reference/system/xgameui/functions/xgameuishowplayerpickerresult)<br />[XGameUiShowPlayerPickerResultCount](/pt-BR/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount)<br />[Ciclo de vida do jogo XBOX (tópico sob NDA)](/pt-BR/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)