Skip to main content

GameInputHapticInfo

Descreve recursos e metadados hápticos.

Sintaxe

Membros

audioEndpointId
Tipo: wchar_t
O identificador do ponto de extremidade de áudio háptico do WASAPI. locationCount
Tipo: uint32_t
Número de locais hápticos. locations
Tipo: GUID
Lista de locais hápticos.

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 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 que pode ser usada para acessar o dispositivo háptico por meio do 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:
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.

Requisitos

Cabeçalho: GameInput.h Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

Visão geral do GameInput
GetHapticInfo
GameInput
Cadeias de caracteres de ID de ponto de extremidade

Histórico de versões

Last modified on October 6, 2026