Passer au contenu principal
Récupère les propriétés de capteurs du périphérique, comme les capteurs de mouvement et d’orientation dont il dispose.

Syntaxe

Paramètres

info   _Out_
Type : GameInputSensorsInfo*
Pointeur vers une structure GameInputSensorsInfo qui reçoit les propriétés de capteurs du périphérique. Si le périphérique ne prend pas en charge l’entrée de capteur, chaque membre de la structure est mis à zéro.

Valeur de retour

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

Remarques

La méthode GetSensorsInfo copie les propriétés de capteurs du périphérique dans la structure fournie par l’appelant. Un périphérique prend en charge l’entrée de capteur lorsque la valeur retournée par GetSupportedInput inclut GameInputKindSensors. Si le périphérique ne prend pas en charge l’entrée de capteur, GetSensorsInfo initialise info à zéro et retourne false. Le membre supportedSensors est une combinaison d’indicateurs GameInputSensorsKind qui identifie les capteurs du périphérique. L’état des capteurs se lit à partir des lectures à l’aide de IGameInputReading::GetSensorsState. 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, lorsque le périphérique se connecte) et mettre le résultat en cache. L’exemple suivant montre comment interroger les propriétés de capteurs d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles dans le membre sensorsInfo 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
GameInputSensorsInfo
GetSupportedInput
GameInputKind
GameInputSensorsKind
IGameInputReading::GetSensorsState
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026