Partager via


Rapports d’entrée du contrôleur radial Windows

Cette rubrique détaille les rapports d’entrée IHM utilisés pour la prise en charge des retours haptiques du contrôleur radial dans les systèmes d’exploitation Windows 10, version 1607 et ultérieurs.

L’hôte utilise les utilisations suivantes lors de l’extraction de données à partir d’un rapport d’entrée :

Membre Description Page id Obligatoire/facultatif
Bouton État du bouton situé sur le contrôleur radial 0x09 0x01 Obligatoire
Composer Rotation relative du contrôleur radial 0x01 0x37 Obligatoire
X Coordonnée X de la position de contact 0x01 0x30 Facultatif
O Coordonnée Y de la position de contact 0x01 0x31 Facultatif
Largeur Largeur du cadre de limitation autour d’un contact 0x0D 0x48 Facultatif
Hauteur Hauteur du cadre de limitation autour d’un contact 0x0D 0x49 Facultatif

Utilisations facultatives obligatoires et prises en charge par Windows

Tout appareil qui ne signale pas toutes les utilisations obligatoires ne sera pas fonctionnel en tant que contrôleur radial Windows. Les utilisations obligatoires sont strictement appliquées par l’hôte Windows. Lorsqu’une valeur maximale logique n’a pas été restreinte, elle peut être optimisée pour réduire la taille du descripteur.

Les sections suivantes fournissent plus de détails sur les utilisations facultatives obligatoires et prises en charge par Windows qui ont été présentées dans le tableau ci-dessus.

Bouton

Permet d’indiquer quand le bouton principal de l’appareil de contrôleur radial est enfoncé. Cela est indiqué par un élément principal avec une taille de rapport de 1 bit. Lors de la remise d’un rapport d’entrée, le bit doit être défini lorsque ce bouton est enfoncé et effacé lorsque le bouton est relâché.

Composer

Utilisé pour indiquer la rotation dans le sens des aiguilles d’une montre du contrôleur radial autour de son propre axe principal. Lors de la remise d’un rapport d’entrée, la valeur signalée doit être l’ampleur de la rotation relative au rapport précédent. Cette valeur est positive si le contrôleur radial est pivoté dans le sens des aiguilles d’une montre et négative si le contrôleur radial est pivoté dans le sens inverse des aiguilles d’une montre.

La plage physique et la plage logique doivent être spécifiées. Les degrés ou radians peuvent être utilisés pour la plage physique. Dans les deux cas, la plage logique doit être suffisamment grande pour signaler des valeurs exactes à au moins une décimale.

X/Y

X et Y indiquent les coordonnées du contact d’un contrôleur radial à l’écran. Cette coordonnée représente le centre du contact relatif à l’affichage.

Les appareils qui signalent X et Y doivent également signaler une utilisation de la largeur ou de la hauteur. L’hôte utilise la coordonnée signalée pour générer le rectangle englobant autour du contact.

Les éléments globaux suivants doivent être spécifiés pour les utilisations de X et Y :

  • Minimum logique
  • Maximum logique
  • Minimum physique
  • Maximum physique
  • Unité
  • Exposant d’unité

La plage physique de l’appareil et les unités doivent être signalées avec précision. Si les informations sont inexactes, l’appareil ne fonctionnera pas correctement. Les appareils doivent également signaler des données dans la plage logique spécifiée dans le descripteur de rapport.

X et Y peuvent fournir une valeur NULL au système, ce qui implique que l’appareil n’a actuellement pas de position par rapport à un affichage, en fournissant une valeur en dehors de la plage logique signalée et en ajoutant le support Null au rapport d’entrée de l’utilisation (Bit 6 {Aucune position Null (0) | État Null(1)}).

Largeur et hauteur

Les utilisations de largeur et hauteur représentent la largeur et la hauteur du cadre de limitation autour du contact du contrôleur radial. La largeur et la hauteur doivent être définies en tant que constantes dans le descripteur de rapport.

Un appareil de contrôleur radial Windows est supposé être circulaire par le système. Pour cette raison, il n’est pas nécessaire de signaler à la fois la largeur et la hauteur d’un contact à l’écran. Si la hauteur ou la largeur est prise en charge, les limites du contact sont interprétées correctement par le système. Windows ne prend pas en charge les périphériques de contrôleur radial avec des valeurs différentes pour la largeur et la hauteur.