Passer au contenu principal
Obtient l’index d’utilisateur XInput attribué au périphérique d’entrée, le cas échéant.

Syntaxe

Paramètres

index   _Out_
Type : uint32_t*
Reçoit l’index d’utilisateur XInput de base zéro (de 0 à 3) du périphérique. Si le périphérique n’a pas d’index d’utilisateur XInput, cette valeur est définie sur 0.

Valeur de retour

Type : bool true si le périphérique dispose actuellement d’un index d’utilisateur XInput ; sinon, false.

Remarques

L’index d’utilisateur XInput est l’emplacement de manette que l’API XInput utilise pour identifier une manette, et qui correspond généralement à l’indicateur de joueur affiché sur la manette. Utilisez cette méthode pour mettre en correspondance un périphérique GameInput avec la manette à laquelle le même index d’utilisateur fait référence dans XInput, par exemple lors de la migration d’un titre de XInput vers GameInput, une manette à la fois. Seuls les périphériques exposés via XInput disposent d’un index d’utilisateur. Les autres périphériques, comme les claviers, les souris et la plupart des contrôleurs de jeu HID, retournent false. Les périphériques agrégés n’ont jamais d’index d’utilisateur XInput. Lorsqu’un périphérique se déconnecte, son index d’utilisateur est libéré et la méthode retourne false. Contrairement à la plupart des propriétés de périphérique, l’index d’utilisateur XInput peut changer pendant que le périphérique est connecté. Lorsqu’il change, GameInput avertit les rappels de périphérique inscrits avec la valeur GameInputDeviceEventXInputIndexUpdated de GameInputDeviceEvent. Appelez à nouveau GetXInputDeviceIndex depuis le rappel pour obtenir le nouvel index.

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
GameInputDeviceEvent
IGameInput::RegisterDeviceCallback

Historique des versions

Dernière modification le 6 novembre 2026