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 완료 후 XGameUiShowPlayerPickerResultCount 및 XGameUiShowPlayerPickerResult를 호출하세요.설명
플레이어 ID는 uint64_t 값인 XBOX User Id(XUID)여야 합니다. UI를 호출하면 게임이 제한 모드(constrained mode) 로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 더 적은 시스템 리소스를 받게 됩니다. 제한 모드 및 타이틀의 기타 작동 모드에 대해 자세히 알아보려면 XBOX 게임 수명 주기(NDA 항목)를 참조하세요.요구 사항
헤더: XGameUI.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔함께 보기
XGameUIXGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
XBOX 게임 수명 주기(NDA 항목)
