Skip to main content

XGameUiShowPlayerPickerAsync

显示一个选取器 UI,允许玩游戏的人从呈现的人员列表中选择玩家。

语法

参数

async _In_
类型:XAsyncBlock*
指向传递给 XAsyncRunXAsyncBlock 的指针。 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 必须是 XBOX 用户 ID (XUID),这是 uint64_t 值。 调用 UI 将使游戏进入_受限模式_。在受限模式下,当你的游戏处于所调用 UI 的后台时,它将获得较少的系统资源。若要详细了解受限模式和游戏的其他运行模式,请阅读 XBOX 游戏生命周期(NDA 主题)

要求

标头: XGameUI.h 库: xgameruntime.lib 支持的平台: Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机

另请参阅

XGameUI
XGameUiShowPlayerPickerResult
XGameUiShowPlayerPickerResultCount
XBOX 游戏生命周期(NDA 主题)
最后修改于 2026年8月24日