> ## 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.

# IGameInputDevice::GetDeviceId

> Obtient l'ID local à l'application qui identifie de manière unique le périphérique d'entrée.

Obtient l'ID local à l'application qui identifie de manière unique le périphérique d'entrée.

## Syntaxe

```cpp theme={null}
void GetDeviceId(
    APP_LOCAL_DEVICE_ID* deviceId
);
```

### Paramètres

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

Reçoit l'ID local à l'application du périphérique.

### Valeur de retour

Type : void

## Remarques

L'ID de périphérique est un ID local à l'application : une valeur de hachage de 256 bits qui identifie le périphérique de manière unique. Cet ID reste le même pour un périphérique donné, même entre les exécutions d'une application ou les redémarrages du système, tant que le périphérique est connecté au même port USB. Le hachage est généré en partie à partir d'informations propres à l'application appelante et au système ; un même périphérique a donc des ID différents dans des applications différentes.

Comme l'ID est stable, vous pouvez le stocker pour mémoriser un périphérique, comme la manette préférée d'un utilisateur, puis rechercher ultérieurement l'objet périphérique correspondant en appelant [IGameInput::FindDeviceFromId](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md).

Pour les périphériques qui constituent l'une des multiples interfaces d'un périphérique composite, utilisez [IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md) pour obtenir l'ID du périphérique racine. Si le périphérique ne fait pas partie d'un périphérique composite, l'ID de périphérique et l'ID du périphérique racine sont identiques.

Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre `deviceId` de la structure [GameInputDeviceInfo](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) retournée par [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Configuration requise

**En-tête :** GameInput.h

**Bibliothèque :** gameinput.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Vue d'ensemble de GameInput](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md)\
[IGameInput::FindDeviceFromId](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)\
[APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/fr/reference/system/xuser/structs/app_local_device_id.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduite. |


## Related topics

- [IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md)
- [IGameInputDevice::IsConnected](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md)
- [Utilisateurs et périphériques d'entrée](https://docs.xbox.com/fr/build/core-features/common/user/users-input-devices.md)
- [IGameInputDevice::GetContainerId](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontainerid.md)
- [IGameInputDevice::GetVendorId](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getvendorid.md)