> ## 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 façon unique le périphérique d'entrée.

Obtient l'ID local à l'application qui identifie de façon 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-CA/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 de façon unique le périphérique. Cet ID reste le même pour un périphérique donné, même d'une exécution de l'application à l'autre ou après un redémarrage du système, tant que le périphérique se connecte 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.

Puisque 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 retrouver plus tard l'objet de périphérique correspondant en appelant [IGameInput::FindDeviceFromId](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md).

Pour les périphériques qui constituent l'une des interfaces d'un périphérique composite, utilisez [IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/fr-CA/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 dans le membre `deviceId` de la structure [GameInputDeviceInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) retournée par [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/fr-CA/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-CA/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md)\
[IGameInput::FindDeviceFromId](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)\
[APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/fr-CA/reference/system/xuser/structs/app_local_device_id.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduit. |


## Related topics

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