Skip to main content

GetHapticInfo

Fournit des renseignements dynamiques sur l’ensemble des propriétés et des capacités haptiques d’un appareil d’entrée.

Syntaxe

Paramètres

info   _Out_
Type : GameInputHapticInfo*
Structure contenant les métadonnées haptiques de l’appareil actuel.

Valeur de retour

Type : HRESULT Retourne GAMEINPUT_E_HAPTIC_NOT_FOUND si les capacités haptiques ne sont pas prêtes (ou autrement disponibles) pour l’appareil actuel.

Remarques

La méthode GetHapticInfo interroge les métadonnées haptiques de l’appareil actuel. Comme l’haptique repose sur la pile audio de Windows, il est possible que ces renseignements ne soient pas encore disponibles au moment de l’arrivée de l’appareil. Plutôt que d’appeler la méthode GetHapticInfo au moment de la connexion de l’appareil, il est fortement recommandé de s’inscrire aux rappels d’appareil et d’attendre la notification d’état de l’appareil GameInputDeviceHapticInfoReady. Cela garantit que les appareils dotés de capacités haptiques disposent du temps nécessaire pour initialiser les ressources requises avant d’être interrogés pour obtenir leurs métadonnées.

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
GameInputHapticInfo
RegisterDeviceCallback
GameInputDeviceStatus
IGameInputDevice

Historique des versions

Last modified on October 6, 2026