Skip to main content

XUserDeviceAssociationChange

Spécifie l’ancienne et la nouvelle association d’appareil lorsqu’une association d’appareil change.

Syntaxe

Membres

deviceId
Type : APP_LOCAL_DEVICE_ID
L’ID de l’appareil dont l’association utilisateur change. oldUser
Type : XUserLocalId
L’ancien ID utilisateur associé à l’appareil. newUser
Type : XUserLocalId
Le nouvel ID utilisateur associé à l’appareil.

Remarques

Tous les arguments de XUserDeviceAssociationChange peuvent être « null » :
  • Si deviceId est égal à XUserNullDeviceId, la modification d’utilisateur s’applique à tous les appareils, tous les appareils étant associés à un utilisateur connecté.
  • Si oldUser est égal à XUserNullUserLocalId, l’association appareil-utilisateur est nouvelle.
  • Si newUser est égal à XUserNullUserLocalId, l’association appareil-utilisateur existante est perdue.
newUser ne peut référencer que des utilisateurs déjà ajoutés au titre via un appel à XUserAddAsync. Si le sélecteur système a été utilisé pour associer un périphérique d’entrée à un utilisateur que le titre ne connaît pas, newUser sera égal à XUserNullUserLocalId. Pour plus d’informations, consultez Utilisateurs et périphériques d’entrée.
Ces membres doivent être traités comme une structure d’octets bruts pouvant être comparée à l’aide de memcmp ou d’une méthode équivalente. Par exemple :
La fonction de rappel XUserDeviceAssociationChangedCallback utilise un pointeur vers une structure XUserDeviceAssociationChange. La fonction de rappel passe le contexte à la fonction XUserRegisterForDeviceAssociationChanged lors de l’inscription du rappel. La fonction XUserRegisterForDeviceAssociationChanged inscrit un rappel pour les événements de modification de l’association entre utilisateur et appareil.

Configuration requise

En-tête : XUser.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

XUser XUserDeviceAssociationChangedCallback XUserRegisterForDeviceAssociationChanged
Last modified on October 6, 2026