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

# GameInputHapticInfo

> GameInputHapticInfo

# GameInputHapticInfo

Décrit les fonctionnalités et les métadonnées haptiques.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
constexpr uint32_t GAMEINPUT_HAPTIC_MAX_LOCATIONS              = 8;
constexpr uint32_t GAMEINPUT_HAPTIC_MAX_AUDIO_ENDPOINT_ID_SIZE = 256;

DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_NONE,          0x00000000, 0x0000, 0x0000, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00);
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_GRIP_LEFT,     0x08c707c2, 0x66bb, 0x406c, 0xa8, 0x4a, 0xdf, 0xe0, 0x85, 0x12, 0x0a, 0x92);
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_GRIP_RIGHT,    0x155a0b77, 0x8bb2, 0x40db, 0x86, 0x90, 0xb6, 0xd4, 0x11, 0x26, 0xdf, 0xc1);
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_TRIGGER_LEFT,  0x8de4d896, 0x5559, 0x4081, 0x86, 0xe5, 0x17, 0x24, 0xcc, 0x07, 0xc6, 0xbc);
DEFINE_GUID(GAMEINPUT_HAPTIC_LOCATION_TRIGGER_RIGHT, 0xff0cb557, 0x3af5, 0x406b, 0x8b, 0x0f, 0x55, 0x5a, 0x2d, 0x92, 0xa2, 0x20);

struct GameInputHapticInfo
{
    wchar_t  audioEndpointId[GAMEINPUT_HAPTIC_MAX_AUDIO_ENDPOINT_ID_SIZE];
    uint32_t locationCount;
    GUID     locations[GAMEINPUT_HAPTIC_MAX_LOCATIONS];
};
```

<a id="membersSection" />

### Membres

*audioEndpointId*<br />
Type : wchar\_t

Identificateur du point de terminaison audio haptique WASAPI.

*locationCount*<br />
Type : uint32\_t

Nombre d'emplacements haptiques.

*locations*<br />
Type : GUID

Liste des emplacements haptiques.

<a id="remarksSection" />

## Remarques

Les manettes compatibles haptiques ressemblent fortement aux périphériques audio à usage général tels que les casques ou les haut-parleurs de bureau ; elles sont pilotées par le système audio de Windows. La structure `GameInputHapticInfo` permet d'associer un point de terminaison audio haptique à un périphérique GameInput spécifique. La méthode [GetHapticInfo](/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo) peut être utilisée pour interroger ces informations une fois que le périphérique signale qu'il est prêt.

`audioEndpointId` est une [chaîne d'identificateur de point de terminaison](https://learn.microsoft.com/windows/win32/coreaudio/endpoint-id-strings) qui peut être utilisée pour accéder au périphérique haptique via [WASAPI](https://learn.microsoft.com/windows/win32/coreaudio/wasapi), ou via l'une des nombreuses API audio de niveau supérieur. Une fois le point de terminaison ouvert, il vous suffit de diffuser votre forme d'onde haptique vers le périphérique.

Les périphériques audio conventionnels disposent d'emplacements bien définis pour les haut-parleurs, tels qu'avant gauche, avant droit et centre. La situation est plus nuancée pour les manettes haptiques, car le périphérique peut prendre en charge un retour haptique à des emplacements physiques qui ne correspondent pas bien à la métaphore du système audio surround. Afin d'adapter les index de canaux audio existants aux emplacements haptiques, un mappage propre au périphérique est fourni. Le nombre d'emplacements haptiques est toujours supérieur à zéro pour les manettes qui prennent en charge l'haptique. La liste des emplacements contient des mappages 1:1 vers les index de canaux audio. Les emplacements répétés ne sont pas autorisés, à l'exception de `GAMEINPUT_HAPTIC_LOCATION_NONE`, qui peut servir de remplissage pour les points de terminaison qui combinent des points de terminaison audio et haptiques. Pour illustrer ce point, examinons la liste d'emplacements ci-dessous :

```cpp theme={null}
{ GAMEINPUT_HAPTIC_LOCATION_NONE, GAMEINPUT_HAPTIC_LOCATION_NONE, GAMEINPUT_HAPTIC_LOCATION_GRIP_LEFT, GAMEINPUT_HAPTIC_LOCATION_GRIP_RIGHT }
```

Dans cet exemple, les canaux 0 et 1 ne sont pas utilisés, et les canaux 2 et 3 sont mappés respectivement à la poignée gauche et à la poignée droite. La liste des emplacements haptiques pourra être étendue dans les futures versions de GameInput.

<a id="requirementsSection" />

## Configuration requise

**En-tête :** GameInput.h

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Documentation conceptuelle

* [Exigences haptiques de GameInput](/fr/build/core-features/common/input/hardware/input-hardware-haptics)

## Voir aussi

[Vue d'ensemble de GameInput](/fr/build/core-features/common/input/overviews/input-overview)<br />
[GetHapticInfo](/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo)<br />
[GameInput](/fr/reference/input/gameinput/gameinput_members)<br />
[Chaînes d'ID de point de terminaison](https://learn.microsoft.com/windows/win32/coreaudio/endpoint-id-strings)

## Historique des versions

| Version | Modifications |
| - | - |
| **v2** | **Nouvelle structure** introduite dans la v2. |
| **v1** | Absente. |
| **v0** | Absente. |


## Related topics

- [GameInputHapticInfo](/reference/input/gameinput/structs/gameinputhapticinfo.md)
- [Haptics in GameInput](/build/core-features/common/input/hardware/input-hardware-haptics.md)
- [GetHapticInfo](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo.md)
- [GameInputHapticFeedbackMotorInfo](/reference/input/gameinput/deprecated/structs/gameinputhapticfeedbackmotorinfo.md)
- [Hápticos en GameInput](/es/build/core-features/common/input/hardware/input-hardware-haptics.md)