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

게임을 플레이 중인 사람이 표시된 사람 목록에서 플레이어를 선택할 수 있도록 하는 선택기 UI를 표시합니다.

## 구문

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

### 매개 변수

*async*   \_In\_\
형식: [XAsyncBlock\*](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)

[XAsyncRun](https://docs.xbox.com/ko/reference/system/xasync/functions/xasyncrun.md)에 전달되는 [XAsyncBlock](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)에 대한 포인터입니다.

*requestingUser*   \_In\_\
형식: XUserHandle

플레이어 선택기 UI를 요청하는 사용자에 대한 핸들입니다.

*promptText*   \_In\_z\_\
형식: char\*

프롬프트 표시 텍스트입니다.

*selectFromPlayersCount*   \_In\_\
형식: uint32\_t

호출자가 선택할 수 있는 플레이어 수입니다.

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

호출자가 선택할 수 있는 플레이어 ID 목록에 대한 포인터입니다.

*preSelectedPlayersCount*   \_In\_\
형식: uint32\_t

UI가 표시될 때 미리 선택되는 플레이어 수입니다.

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

UI가 표시될 때 미리 선택되는 플레이어 ID 목록에 대한 포인터입니다.

*minSelectionCount*   \_In\_\
형식: uint32\_t

호출자가 반드시 선택해야 하는 최소 인원 수입니다.

*maxSelectionCount*   \_In\_\
형식: uint32\_t

호출자가 선택할 수 있는 최대 인원 수입니다.

### 반환 값

형식: HRESULT

비동기 호출의 HRESULT 성공 또는 오류 코드입니다.

결과를 가져오려면 *AsyncBlock* 콜백 내부 또는 *AsyncBlock* 완료 후 [XGameUiShowPlayerPickerResultCount](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount.md) 및 [XGameUiShowPlayerPickerResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md)를 호출하세요.

## 설명

플레이어 ID는 *uint64\_t* 값인 XBOX User Id(XUID)여야 합니다.

UI를 호출하면 게임이 *제한 모드(constrained mode)* 로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 더 적은 시스템 리소스를 받게 됩니다. 제한 모드 및 타이틀의 기타 작동 모드에 대해 자세히 알아보려면 [XBOX 게임 수명 주기(NDA 항목)](https://docs.xbox.com/ko/build/console-features/console-workflows/xbox-game-life-cycle.md)를 참조하세요.

## 요구 사항

**헤더:** XGameUI.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, Steam Deck, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XGameUI](https://docs.xbox.com/ko/reference/system/xgameui/xgameui_members.md)\
[XGameUiShowPlayerPickerResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md)\
[XGameUiShowPlayerPickerResultCount](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount.md)\
[XBOX 게임 수명 주기(NDA 항목)](https://docs.xbox.com/ko/build/console-features/console-workflows/xbox-game-life-cycle.md)


## Related topics

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