Skip to main content

XGameUiShowPlayerPickerAsync

Muestra una interfaz de usuario de selección que permite a una persona que juega al juego seleccionar jugadores de una lista de personas presentada.

Sintaxis

Parámetros

async _In_
Tipo: XAsyncBlock*
Un puntero al XAsyncBlock que se pasa a XAsyncRun. requestingUser _In_
Tipo: XUserHandle
Un identificador del usuario que solicita la interfaz de usuario del selector de jugadores. promptText _In_z_
Tipo: char*
El texto de la solicitud que se muestra. selectFromPlayersCount _In_
Tipo: uint32_t
El número de jugadores entre los que puede elegir el autor de la llamada. selectFromPlayers _In_reads_(selectFromPlayersCount)
Tipo: uint64_t*
Un puntero a una lista de identificadores de jugadores entre los que puede elegir el autor de la llamada. preSelectedPlayersCount _In_
Tipo: uint32_t
El número de jugadores que están preseleccionados cuando se presenta la interfaz de usuario. preSelectedPlayers _In_reads_opt_(preSelectedPlayersCount)
Tipo: uint64_t*
Un puntero a una lista de identificadores de jugadores que están preseleccionados cuando se presenta la interfaz de usuario. minSelectionCount _In_
Tipo: uint32_t
El número mínimo de personas que debe seleccionar el autor de la llamada. maxSelectionCount _In_
Tipo: uint32_t
El número máximo de personas que puede seleccionar el autor de la llamada.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error de la llamada asincrónica. Para obtener el resultado, llame a XGameUiShowPlayerPickerResultCount y XGameUiShowPlayerPickerResult dentro de la devolución de llamada de AsyncBlock o después de que AsyncBlock se haya completado.

Comentarios

Los identificadores de jugadores deben ser identificadores de usuario de XBOX (XUID), que son un valor uint64_t. Llamar a la interfaz de usuario hará que el juego entre en modo restringido. En modo restringido, el título recibirá menos recursos del sistema mientras esté en segundo plano respecto de la interfaz de usuario que se haya invocado. Para obtener más información sobre el modo restringido y otros modos operativos del título, lea Ciclo de vida del juego de XBOX (tema NDA).

Requisitos

Encabezado: XGameUI.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

XGameUI
XGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
Ciclo de vida del juego de XBOX (tema NDA)
Última modificación el 28 de agosto de 2026