> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserDeviceAssociationChange

> XUserDeviceAssociationChange

# XUserDeviceAssociationChange

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

## Syntaxe

```cpp theme={null}
typedef struct XUserDeviceAssociationChange {  
    APP_LOCAL_DEVICE_ID deviceId;  
    XUserLocalId oldUser;  
    XUserLocalId newUser;  
} XUserDeviceAssociationChange  
```

### Membres

*deviceId*\
Type : [APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/fr-CA/reference/system/xuser/structs/app_local_device_id.md)

L'ID du périphérique dont l'association d'utilisateur change.

*oldUser*\
Type : [XUserLocalId](https://docs.xbox.com/fr-CA/reference/system/xuser/structs/xuserlocalid.md)

L'ancien ID d'utilisateur associé au périphérique.

*newUser*\
Type : [XUserLocalId](https://docs.xbox.com/fr-CA/reference/system/xuser/structs/xuserlocalid.md)

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.

> [!NOTE]
>
> *newUser* peut uniquement référencer des utilisateurs qui ont déjà été ajoutés au titre au moyen d'un appel à [XUserAddAsync](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuseraddasync.md). 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](https://docs.xbox.com/fr-CA/build/core-features/common/user/users-input-devices.md).

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 :

```cpp theme={null}
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))
{
}
```

La fonction de rappel [XUserDeviceAssociationChangedCallback](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md) utilise un pointeur vers une structure XUserDeviceAssociationChange.

La fonction de rappel passe le contexte à la fonction [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md) lors de l'inscription du rappel.

La fonction [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md) 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](https://docs.xbox.com/fr-CA/reference/system/xuser/xuser_members.md)

[XUserDeviceAssociationChangedCallback](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md)

[XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md)


## Related topics

- [XUserDeviceAssociationChangedCallback](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md)
- [XUser (contenu de l'API)](https://docs.xbox.com/fr-CA/reference/system/xuser/xuser_members.md)
- [APP_LOCAL_DEVICE_ID](https://docs.xbox.com/fr-CA/reference/system/xuser/structs/app_local_device_id.md)
- [XUserUnregisterForDeviceAssociationChanged](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserunregisterfordeviceassociationchanged.md)
- [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr-CA/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md)