Skip to main content

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

Parâmetros

async _In_
Tipo: XAsyncBlock*
Um ponteiro para o XAsyncBlock que é passado para XAsyncRun. 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 e 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).

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
XGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
Ciclo de vida do jogo XBOX (tópico sob NDA)
Last modified on October 6, 2026