> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetHapticInfo

> GetHapticInfo

# 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.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT GetHapticInfo(
    GameInputHapticInfo* info);
```

### Paramètres

*info*   \_Out\_\
Type : [GameInputHapticInfo](/fr/reference/input/gameinput/structs/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.

<a id="remarksSection" />

## 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](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback) et d'attendre la notification d'[état du périphérique](/fr/reference/input/gameinput/enums/gameinputdevicestatus) `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.

<a id="requirementsSection" />

## 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

<a id="seealsoSection" />

## Voir aussi

[Vue d'ensemble de GameInput](/fr/build/core-features/common/input/overviews/input-overview)<br />
[GameInputHapticInfo](/fr/reference/input/gameinput/structs/gameinputhapticinfo)<br />
[RegisterDeviceCallback](/fr/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)<br />
[GameInputDeviceStatus](/fr/reference/input/gameinput/enums/gameinputdevicestatus)<br />
[IGameInputDevice](/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Historique des versions

| Version | Modifications |
| - | - |
| **v2** | Introduite. |


## Related topics

- [GameInputHapticInfo](/fr/reference/input/gameinput/structs/gameinputhapticinfo.md)
- [Haptique dans GameInput](/fr/build/core-features/common/input/hardware/input-hardware-haptics.md)
- [IGameInputDevice](/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [GameInput](/fr/reference/input/gameinput/gameinput_members.md)
- [Membres obsolètes de l'API GameInput](/fr/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
