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 必须是 XBOX 用户 ID (XUID),这是 uint64_t 值。 调用 UI 将使游戏进入_受限模式_。在受限模式下,当你的游戏处于所调用 UI 的后台时,它将获得较少的系统资源。若要详细了解受限模式和游戏的其他运行模式,请阅读 XBOX 游戏生命周期(NDA 主题)。要求
标头: XGameUI.h 库: xgameruntime.lib 支持的平台: Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机另请参阅
XGameUIXGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
XBOX 游戏生命周期(NDA 主题)
