Skip to main content

XUserFindControllerForUserWithUiAsync

显示一个对话框,提示用户打开并识别他们想要使用的控制器。

语法

参数

user   _In_
类型:XUserHandle
要为其查找控制器的用户的 XUserHandle。 async   _In_
类型:XAsyncBlock*
用于轮询调用状态并检索调用结果的 XAsyncBlock。

返回值

类型:HRESULT HRESULT 成功或错误代码。有关错误代码列表,请参阅 错误代码

注解

在桌面上,此函数不会显示 UI。 若要获取用户选择的控制器的结果,有几种选择。
  1. 调用 XUserFindControllerForUserWithUiResult。 这将返回现已绑定控制器的设备 ID。
  2. XUserDeviceAssociationChangedCallback 回调获取结果,该回调将在用户选择了新控制器后发生。

要求

头文件: XUser.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

XUser
处理控制器丢失(NDA 主题)
最后修改于 2026年8月24日