Skip to main content

GetHapticInfo

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

Sintaxe

Parâmetros

info   _Out_
Tipo: 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.

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 e aguardar a notificação de status do dispositivo 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
GameInputHapticInfo
RegisterDeviceCallback
GameInputDeviceStatus
IGameInputDevice

Histórico de versões

Last modified on October 6, 2026