通过

XUserDeviceAssociationChange

  • 项目

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

语法

typedef struct XUserDeviceAssociationChange {  
    APP_LOCAL_DEVICE_ID deviceId;  
    XUserLocalId oldUser;  
    XUserLocalId newUser;  
} 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 或等效方法进行比较的原始字节结构。 例如：

XUserDeviceAssociationChange *change; // incoming argument from callback

if(memcmp(&change->deviceId, &XUserNullDeviceId, sizeof(APP_LOCAL_DEVICE_ID) == 0))
{
}

if(memcmp(&change->newUser, &XUserNullUserLocalId, sizeof(XUserLocalId) == 0))
{
}

XUserDeviceAssociationChangedCallback 回调函数使用指向 XUserDeviceAssociationChange 结构的指针。

注册回调时，回调函数会将上下文传递给 XUserRegisterForDeviceAssociationChanged 函数。

XUserRegisterForDeviceAssociationChanged 函数为用户设备关联更改事件注册回调。

要求

头文件：XUser.h

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XUser

XUserDeviceAssociationChangedCallback

XUserRegisterForDeviceAssociationChanged