Skip to main content

XUserDeviceAssociationChange

Spécifie l’ancienne et la nouvelle association de périphérique lorsqu’une association de périphérique change.

Syntaxe

Membres

deviceId
Type : APP_LOCAL_DEVICE_ID
L’ID du périphérique dont l’association d’utilisateur change. oldUser
Type : XUserLocalId
L’ancien ID d’utilisateur associé au périphérique. newUser
Type : XUserLocalId
Le nouvel ID d’utilisateur associé au périphérique.

Remarques

Tous les arguments de XUserDeviceAssociationChange peuvent être « nuls » :
  • Si deviceId est égal à XUserNullDeviceId, la modification d’utilisateur s’applique à tous les périphériques, tous les périphériques étant associés à un utilisateur connecté.
  • Si oldUser est égal à XUserNullUserLocalId, l’association périphérique-utilisateur est nouvelle.
  • Si newUser est égal à XUserNullUserLocalId, l’association périphérique-utilisateur existante est perdue.
newUser peut uniquement référencer des utilisateurs qui ont déjà été ajoutés au titre au moyen d’un appel à XUserAddAsync. Si le sélecteur système a été utilisé pour jumeler 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 l’utilisateur et le périphérique.

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