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

게임을 플레이 중인 사람이 표시된 사람 목록에서 플레이어를 선택할 수 있도록 하는 선택기 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\_<br />형식: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

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

*requestingUser*   \_In\_<br />형식: XUserHandle

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

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

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

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

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

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

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

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

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

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

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

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

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

*maxSelectionCount*   \_In\_<br />형식: uint32\_t

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

### 반환 값

형식: HRESULT

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

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

## 설명

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

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

## 요구 사항

**헤더:** XGameUI.h

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

**지원 플랫폼:** Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XGameUI](/reference/system/xgameui/xgameui_members)<br />[XGameUiShowPlayerPickerResult](/reference/system/xgameui/functions/xgameuishowplayerpickerresult)<br />[XGameUiShowPlayerPickerResultCount](/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount)<br />[XBOX 게임 수명 주기(NDA 항목)](/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

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