Pular para o conteúdo principal
Recupera as propriedades de mouse do dispositivo, como os botões com suporte, a taxa de amostragem e as rodas de rolagem.

Sintaxe

Parâmetros

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

Valor retornado

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

Comentários

O método GetMouseInfo copia as propriedades de mouse do dispositivo para a estrutura fornecida pelo chamador. Um dispositivo oferece suporte à entrada de mouse quando o valor retornado por GetSupportedInput inclui GameInputKindMouse. Se o dispositivo não oferecer suporte à entrada de mouse, GetMouseInfo inicializará info com zeros e retornará false. O membro supportedButtons relata quais GameInputMouseButtons o mouse tem, e os membros hasWheelX e hasWheelY relatam se o mouse tem rodas de rolagem horizontal e vertical. O estado do mouse é lido das leituras por meio de IGameInputReading::GetMouseState. 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 mouse de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro mouseInfo 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
GameInputMouseInfo
GetSupportedInput
GameInputKind
GameInputMouseButtons
IGameInputReading::GetMouseState
IGameInputDevice

Histórico de versões

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