Skip to main content

XUserDeviceAssociationChange

指定当设备关联发生更改时旧的和新的设备关联。

语法

成员

deviceId
类型:APP_LOCAL_DEVICE_ID
用户关联发生更改的设备的 ID。 oldUser
类型:XUserLocalId
与该设备关联的旧用户 ID。 newUser
类型:XUserLocalId
与该设备关联的新用户 ID。

备注

XUserDeviceAssociationChange 的所有参数都可以为 “null”:
  • 如果 deviceId 等于 XUserNullDeviceId,则用户更改适用于所有设备,其中所有设备都与已登录的用户存在关联。
  • 如果 oldUser 等于 XUserNullUserLocalId,则该设备与用户的关联是新的。
  • 如果 newUser 等于 XUserNullUserLocalId,则现有的设备与用户关联已丢失。
newUser 只能引用之前已通过调用 XUserAddAsync 添加到游戏中的用户。如果使用系统选择器将输入设备与游戏未知的用户配对,则 newUser 将等于 XUserNullUserLocalId。有关详细信息,请参阅用户和输入设备
这些成员应被视为可以使用 memcmp 或等效方法进行比较的原始字节结构。例如:
XUserDeviceAssociationChangedCallback 回调函数使用指向 XUserDeviceAssociationChange 结构的指针。 回调函数在回调注册时将上下文传递给 XUserRegisterForDeviceAssociationChanged 函数。 XUserRegisterForDeviceAssociationChanged 函数为用户设备关联更改事件注册回调。

要求

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

另请参阅

XUser XUserDeviceAssociationChangedCallback XUserRegisterForDeviceAssociationChanged
最后修改于 2026年8月24日