Skip to main content

XUserDeviceAssociationChange

Especifica as associações de dispositivo antigas e novas quando uma associação de dispositivo é alterada.

Sintaxe

Membros

deviceId
Tipo: APP_LOCAL_DEVICE_ID
A ID do dispositivo cuja associação de usuário é alterada. oldUser
Tipo: XUserLocalId
A ID de usuário antiga associada ao dispositivo. newUser
Tipo: XUserLocalId
A nova ID de usuário associada ao dispositivo.

Comentários

Todos os argumentos de XUserDeviceAssociationChange podem ser “nulos”:
  • Se deviceId for igual a XUserNullDeviceId, a alteração de usuário se aplicará a todos os dispositivos, em que todos os dispositivos têm associações com um usuário conectado.
  • Se oldUser for igual a XUserNullUserLocalId, a associação dispositivo-usuário será nova.
  • Se newUser for igual a XUserNullUserLocalId, a associação dispositivo-usuário existente será perdida.
newUser só pode referenciar usuários que já foram adicionados ao título por meio de uma chamada para XUserAddAsync. Se o seletor do sistema tiver sido usado para emparelhar um dispositivo de entrada a um usuário que o título não conhece, newUser será igual a XUserNullUserLocalId. Consulte Usuários e dispositivos de entrada para obter mais informações.
Esses membros devem ser tratados como uma estrutura de bytes brutos que pode ser comparada usando memcmp ou um método equivalente. Por exemplo:
A função de retorno de chamada XUserDeviceAssociationChangedCallback usa um ponteiro para uma estrutura XUserDeviceAssociationChange. A função de retorno de chamada passa o contexto para a função XUserRegisterForDeviceAssociationChanged quando o retorno de chamada é registrado. A função XUserRegisterForDeviceAssociationChanged registra um retorno de chamada para eventos de alteração de associação de dispositivo do usuário.

Requisitos

Cabeçalho: XUser.h Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

XUser XUserDeviceAssociationChangedCallback XUserRegisterForDeviceAssociationChanged
Last modified on October 6, 2026