Passer au contenu principal
Obtient l’ID local à l’application qui identifie de façon unique le périphérique d’entrée.

Syntaxe

Paramètres

deviceId   _Out_
Type : APP_LOCAL_DEVICE_ID*
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. Pour les périphériques qui constituent l’une des interfaces d’un périphérique composite, utilisez IGameInputDevice::GetDeviceRootId 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 retournée par IGameInputDevice::GetDeviceInfo.

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
IGameInputDevice
IGameInputDevice::GetDeviceRootId
IGameInput::FindDeviceFromId
APP_LOCAL_DEVICE_ID

Historique des versions

Dernière modification le 6 novembre 2026