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

Descreve recursos e metadados hápticos.

<a id="syntaxSection" />

## Sintaxe

```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" />

### Membros

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

O identificador do ponto de extremidade de áudio háptico do WASAPI.

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

Número de locais hápticos.

*locations*<br />
Tipo: GUID

Lista de locais hápticos.

<a id="remarksSection" />

## Comentários

Os controles com recursos hápticos se assemelham muito a dispositivos de áudio de uso geral, como fones de ouvido ou alto-falantes de desktop; eles são controlados pelo sistema de áudio do Windows. A estrutura `GameInputHapticInfo` possibilita associar um ponto de extremidade de áudio háptico a um dispositivo GameInput específico. O método [GetHapticInfo](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo) pode ser usado para consultar essas informações assim que o dispositivo relatar que está pronto.

O `audioEndpointId` é uma [cadeia de caracteres de identificador de ponto de extremidade](https://learn.microsoft.com/windows/win32/coreaudio/endpoint-id-strings) que pode ser usada para acessar o dispositivo háptico por meio do [WASAPI](https://learn.microsoft.com/windows/win32/coreaudio/wasapi) ou de qualquer uma das várias APIs de áudio de nível mais alto. Depois que o ponto de extremidade for aberto, basta transmitir sua forma de onda háptica para o dispositivo.

Os dispositivos de áudio convencionais têm locais bem definidos para os alto-falantes, como frontal esquerdo, frontal direito e central. A situação dos controles hápticos é mais sutil, pois o dispositivo pode oferecer suporte a feedback háptico em locais físicos que não se encaixam bem na metáfora do sistema de áudio surround. Para adaptar os índices de canais de áudio existentes aos locais hápticos, é fornecido um mapeamento específico do dispositivo. O número de locais hápticos será sempre maior que zero para controles compatíveis com háptica. A lista de locais conterá mapeamentos 1:1 para os índices de canais de áudio. Locais repetidos não são permitidos, com exceção de `GAMEINPUT_HAPTIC_LOCATION_NONE`, que pode ser usado como preenchimento para pontos de extremidade que contêm uma combinação de pontos de extremidade de áudio e hápticos. Para ilustrar, vamos considerar a lista de locais abaixo:

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

Neste exemplo, os canais 0 e 1 não são usados, e os canais 2 e 3 são mapeados para a empunhadura esquerda e a empunhadura direita, respectivamente. A lista de locais hápticos pode ser expandida em versões futuras do GameInput.

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** GameInput.h

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Documentação conceitual

* [Requisitos hápticos do GameInput](/pt-BR/build/core-features/common/input/hardware/input-hardware-haptics)

## Confira também

[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)<br />
[GetHapticInfo](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo)<br />
[GameInput](/pt-BR/reference/input/gameinput/gameinput_members)<br />
[Cadeias de caracteres de ID de ponto de extremidade](https://learn.microsoft.com/windows/win32/coreaudio/endpoint-id-strings)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v2** | **Nova struct** introduzida na v2. |
| **v1** | Não presente. |
| **v0** | Não presente. |


## Related topics

- [GetHapticInfo](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo.md)
- [GameInputHapticFeedbackMotorInfo](/pt-BR/reference/input/gameinput/deprecated/structs/gameinputhapticfeedbackmotorinfo.md)
- [Háptica no GameInput](/pt-BR/build/core-features/common/input/hardware/input-hardware-haptics.md)
- [GameInput](/pt-BR/reference/input/gameinput/gameinput_members.md)
- [Membros preteridos da API GameInput](/pt-BR/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)