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

Fornece informações dinâmicas sobre todas as propriedades e funcionalidades hápticas de um dispositivo de entrada.

<a id="syntaxSection" />

## Sintaxe

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

### Parâmetros

*info*   \_Out\_\
Tipo: [GameInputHapticInfo](/pt-BR/reference/input/gameinput/structs/gameinputhapticinfo)\*

Estrutura que contém metadados hápticos do dispositivo atual.

### Valor retornado

Tipo: HRESULT

Retorna `GAMEINPUT_E_HAPTIC_NOT_FOUND` se as funcionalidades hápticas não estiverem prontas (ou disponíveis de outra forma) para o dispositivo atual.

<a id="remarksSection" />

## Comentários

O método `GetHapticInfo` consulta os metadados hápticos do dispositivo atual. Como a háptica depende da pilha de áudio do Windows, é possível que essas informações ainda não estejam disponíveis no momento da chegada do dispositivo. Em vez de chamar o método `GetHapticInfo` no momento da conexão do dispositivo, é altamente recomendável [registrar-se para retornos de chamada de dispositivo](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback) e aguardar a notificação de [status do dispositivo](/pt-BR/reference/input/gameinput/enums/gameinputdevicestatus) `GameInputDeviceHapticInfoReady`. Isso garantirá que os dispositivos com funcionalidade háptica recebam o tempo necessário para inicializar os recursos necessários antes de serem consultados quanto aos metadados.

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Confira também

[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)<br />
[GameInputHapticInfo](/pt-BR/reference/input/gameinput/structs/gameinputhapticinfo)<br />
[RegisterDeviceCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)<br />
[GameInputDeviceStatus](/pt-BR/reference/input/gameinput/enums/gameinputdevicestatus)<br />
[IGameInputDevice](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v2** | Introduzido. |


## Related topics

- [GetHapticInfo](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo.md)
- [GameInputHapticInfo](/reference/input/gameinput/structs/gameinputhapticinfo.md)
- [Haptics in GameInput](/build/core-features/common/input/hardware/input-hardware-haptics.md)
- [Hápticos en GameInput](/es/build/core-features/common/input/hardware/input-hardware-haptics.md)
- [GameInput 中的触觉反馈](/zh-CN/build/core-features/common/input/hardware/input-hardware-haptics.md)