Passer au contenu principal

GetHapticInfo

Fournit des informations dynamiques sur l’ensemble des propriétés et des capacités haptiques d’un périphérique d’entrée.

Syntaxe

Paramètres

info   _Out_
Type : GameInputHapticInfo*
Structure contenant les métadonnées haptiques du périphérique actuel.

Valeur de retour

Type : HRESULT Retourne GAMEINPUT_E_HAPTIC_NOT_FOUND si les capacités haptiques ne sont pas prêtes (ou pas disponibles d’une autre manière) pour le périphérique actuel.

Remarques

La méthode GetHapticInfo interroge les métadonnées haptiques du périphérique actuel. Comme l’haptique repose sur la pile audio de Windows, il est possible que ces informations ne soient pas encore disponibles au moment de l’arrivée du périphérique. Plutôt que d’appeler la méthode GetHapticInfo au moment de la connexion du périphérique, il est fortement recommandé de s’inscrire aux rappels de périphérique et d’attendre la notification d’état du périphérique GameInputDeviceHapticInfoReady. Cela garantit que les périphériques dotés de capacités haptiques disposent du temps nécessaire pour initialiser les ressources requises avant que leurs métadonnées ne soient interrogé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

Dernière modification le 6 octobre 2026