Passer au contenu principal
Obtient l’ID local à l’application du nœud de périphérique racine du périphérique d’entrée.

Syntaxe

Paramètres

deviceRootId   _Out_
Type : APP_LOCAL_DEVICE_ID*
Reçoit l’ID local à l’application du nœud de périphérique racine.

Valeur de retour

Type : void

Remarques

L’ID du périphérique racine est un ID local à l’application qui identifie le nœud de périphérique racine des périphériques composites. Cela permet aux applications de comprendre la relation entre les différents périphériques. Par exemple, certains claviers de jeu contournent l’ancienne limite USB de huit frappes simultanées en s’exposant comme un périphérique composite doté de plusieurs nœuds de clavier. Ces nœuds sont fusionnés dans le clavier « système », ce qui est généralement transparent pour l’utilisateur. Toutefois, lors du traitement de l’entrée par clavier avec l’API GameInput, le fait de comprendre cette relation aide les applications à éviter des hypothèses erronées (par exemple, qu’une frappe provient toujours d’un périphérique spécifique) lors du mappage de fonctions à des frappes. Les périphériques qui signalent le même ID de périphérique racine appartiennent au même périphérique composite. Si le périphérique n’est pas l’une des multiples interfaces d’un périphérique composite, l’ID du périphérique racine est identique à l’ID retourné par IGameInputDevice::GetDeviceId. Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre deviceRootId 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::GetDeviceId
IGameInputDevice::GetContainerId
APP_LOCAL_DEVICE_ID

Historique des versions

Dernière modification le 6 novembre 2026