> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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.

## Sintaxe

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

### Parâmetros

*info*   \_Out\_\
Tipo: [GameInputHapticInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputhapticinfo.md)\*

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.

## 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](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) e aguardar a notificação de [status do dispositivo](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputdevicestatus.md) `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.

## Requisitos

**Cabeçalho:** GameInput.h

**Biblioteca:** gameinput.lib

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

## Confira também

[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\

[GameInputHapticInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputhapticinfo.md)\

[RegisterDeviceCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)\

[GameInputDeviceStatus](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputdevicestatus.md)\

[IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Histórico de versões

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


## Related topics

- [GameInputHapticInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputhapticinfo.md)
- [Requisitos de háptica do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/hardware/input-hardware-haptics.md)
- [IGameInputDevice (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [Membros da API do GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/gameinput_members.md)
- [Membros preteridos da API GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)