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

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

```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\*](/reference/system/xasync/structs/xasyncblock)

Un puntero al [XAsyncBlock](/reference/system/xasync/structs/xasyncblock) que se pasa a [XAsyncRun](/reference/system/xasync/functions/xasyncrun).

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

Un identificador del usuario que solicita la interfaz de usuario del selector de jugadores.

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

El texto de la solicitud que se muestra.

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

El número de jugadores entre los que puede elegir el autor de la llamada.

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

Un puntero a una lista de identificadores de jugadores entre los que puede elegir el autor de la llamada.

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

El número de jugadores que están preseleccionados cuando se presenta la interfaz de usuario.

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

El número mínimo de personas que debe seleccionar el autor de la llamada.

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

## 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](/reference/system/xgameui/xgameui_members)<br />[XGameUiShowPlayerPickerResult](/reference/system/xgameui/functions/xgameuishowplayerpickerresult)<br />[XGameUiShowPlayerPickerResultCount](/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount)<br />[Ciclo de vida del juego de XBOX (tema NDA)](/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

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