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

L'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 dotées de fonctions haptiques ressemblent beaucoup aux périphériques audio d'usage général, comme les casques d'écoute ou les haut-parleurs d'ordinateur; 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 précis. La méthode [GetHapticInfo](/fr-CA/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 par l'intermédiaire de [WASAPI](https://learn.microsoft.com/windows/win32/coreaudio/wasapi) ou de l'une des nombreuses API audio de plus haut niveau. Une fois le point de terminaison ouvert, vous pouvez simplement 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, comme 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 le retour haptique à des emplacements physiques qui ne correspondent pas bien à la métaphore du système audio ambiophonique. 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 contiennent un mélange de points de terminaison audio et haptiques. À titre d'illustration, 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 pourrait être élargie dans les versions futures 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-CA/build/core-features/common/input/hardware/input-hardware-haptics)

## Voir aussi

[Vue d'ensemble de GameInput](/fr-CA/build/core-features/common/input/overviews/input-overview)<br />
[GetHapticInfo](/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo)<br />
[GameInput](/fr-CA/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 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)