Pular para o conteúdo principal
Recupera as propriedades de sensor do dispositivo, como quais sensores de movimento e orientação ele tem.

Sintaxe

Parâmetros

info   _Out_
Tipo: GameInputSensorsInfo*
Ponteiro para uma estrutura GameInputSensorsInfo que recebe as propriedades de sensor do dispositivo. Se o dispositivo não oferecer suporte à entrada de sensor, todos os membros da estrutura serão definidos como zero.

Valor retornado

Tipo: bool true se o dispositivo oferecer suporte à entrada de sensor e info tiver sido preenchido; caso contrário, false.

Comentários

O método GetSensorsInfo copia as propriedades de sensor do dispositivo para a estrutura fornecida pelo chamador. Um dispositivo oferece suporte à entrada de sensor quando o valor retornado por GetSupportedInput inclui GameInputKindSensors. Se o dispositivo não oferecer suporte à entrada de sensor, GetSensorsInfo inicializará info com zeros e retornará false. O membro supportedSensors é uma combinação de sinalizadores GameInputSensorsKind que identifica os sensores do dispositivo. O estado dos sensores é lido das leituras por meio de IGameInputReading::GetSensorsState. As propriedades retornadas por este método são fixas durante o tempo de vida do dispositivo, portanto você pode consultá-las uma vez (por exemplo, quando o dispositivo se conecta) e armazenar o resultado em cache. O exemplo a seguir mostra como consultar as propriedades de sensor de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro sensorsInfo da estrutura GameInputDeviceInfo retornada por IGameInputDevice::GetDeviceInfo.

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
GameInputSensorsInfo
GetSupportedInput
GameInputKind
GameInputSensorsKind
IGameInputReading::GetSensorsState
IGameInputDevice

Histórico de versões

Última modificação em 6 de novembro de 2026