Skip to main content

XGameUiShowPlayerPickerAsync

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

구문

매개 변수

async _In_
형식: XAsyncBlock*
XAsyncRun에 전달되는 XAsyncBlock에 대한 포인터입니다. 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 완료 후 XGameUiShowPlayerPickerResultCountXGameUiShowPlayerPickerResult를 호출하세요.

설명

플레이어 ID는 uint64_t 값인 XBOX User Id(XUID)여야 합니다. UI를 호출하면 게임이 제한 모드(constrained mode) 로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 더 적은 시스템 리소스를 받게 됩니다. 제한 모드 및 타이틀의 기타 작동 모드에 대해 자세히 알아보려면 XBOX 게임 수명 주기(NDA 항목)를 참조하세요.

요구 사항

헤더: XGameUI.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XGameUI
XGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
XBOX 게임 수명 주기(NDA 항목)
마지막 수정일 2026년 8월 24일