Passer au contenu principal
Récupère les propriétés de souris du périphérique, comme les boutons qu’il prend en charge, sa fréquence d’échantillonnage et ses molettes de défilement.

Syntaxe

Paramètres

info   _Out_
Type : GameInputMouseInfo*
Pointeur vers une structure GameInputMouseInfo qui reçoit les propriétés de souris du périphérique. Si le périphérique ne prend pas en charge l’entrée souris, tous les membres de la structure sont définis sur zéro.

Valeur de retour

Type : bool true si le périphérique prend en charge l’entrée souris et que info a été renseigné ; sinon, false.

Remarques

La méthode GetMouseInfo copie les propriétés de souris du périphérique dans la structure fournie par l’appelant. Un périphérique prend en charge l’entrée souris lorsque la valeur retournée par GetSupportedInput inclut GameInputKindMouse. Si le périphérique ne prend pas en charge l’entrée souris, GetMouseInfo initialise info à zéro et retourne false. Le membre supportedButtons indique les boutons GameInputMouseButtons dont dispose la souris, et les membres hasWheelX et hasWheelY indiquent si la souris dispose de molettes de défilement horizontale et verticale. L’état de la souris est lu à partir des lectures à l’aide de IGameInputReading::GetMouseState. Les propriétés retournées par cette méthode sont fixes pendant toute la durée de vie du périphérique ; vous pouvez donc les interroger une seule fois (par exemple, lors de la connexion du périphérique) et mettre le résultat en cache. L’exemple suivant montre comment interroger les propriétés de souris d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre mouseInfo de la structure GameInputDeviceInfo retournée par IGameInputDevice::GetDeviceInfo.

Configuration requise

En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Vue d’ensemble de GameInput
GameInputMouseInfo
GetSupportedInput
GameInputKind
GameInputMouseButtons
IGameInputReading::GetMouseState
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026