다음을 통해 공유

XGameUiShowPlayerPickerAsync

  • 아티클

게임을 플레이 중인 사용자가 제공된 사용자 목록에서 플레이어를 선택할 수 있는 선택기 UI를 표시합니다.

구문

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*

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 사용자 ID(XUID)여야 합니다.

UI를 호출하면 게임이 제한 모드로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 시스템 리소스를 적게 받게 됩니다. 타이틀의 제한 모드 및 기타 운영 모드에 대한 자세한 내용은 Xbox 게임 수명 주기(NDA 항목)를 참조하세요.

요구 사항

헤더: XGameUI.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XGameUI
XGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
Xbox 게임 수명 주기(NDA 항목)