structure USAGE_PROPERTIES (winuser.h)
Contient des propriétés d’appareil (éléments globaux HID (Human Interface Device) qui correspondent à des utilisations HID) pour n’importe quel type d’appareil d’entrée HID.
Syntaxe
typedef struct tagUSAGE_PROPERTIES {
USHORT level;
USHORT page;
USHORT usage;
INT32 logicalMinimum;
INT32 logicalMaximum;
USHORT unit;
USHORT exponent;
BYTE count;
INT32 physicalMinimum;
INT32 physicalMaximum;
} USAGE_PROPERTIES, *PUSAGE_PROPERTIES;
Membres
level
Valeur spécifique à l’utilisation pour un contrôle linéaire basé sur une plage (bouton ou numérotation), un contrôle activé/désactivé (bouton bascule), un contrôle momentané (bouton de la souris), un contrôle one shot (bouton qui déclenche un événement unique) ou un nouveau contrôle (bouton qui déclenche un événement répété).
page
L’ID de la page d’utilisation, comme la page contrôles VR (0x03) ou la page Contrôles de jeu (0x05).
usage
ID d’utilisation associé à une page d’utilisation, par exemple Tourner à droite/gauche (21) ou Déplacer vers la droite/la gauche (24) pour une page Contrôles de jeu.
logicalMinimum
Valeur la plus petite que le contrôle peut signaler.
logicalMaximum
Valeur la plus élevée que le contrôle peut signaler.
unit
Standard de mesure utilisé pour décrire la valeur physique d’un contrôle (après avoir converti la valeur logique à l’aide de la valeur de l’exposant ). La spécification HID définit des codes pour les unités de base de longueur, de masse, de temps, de température, de courant et d’intensité lumineuse.
exponent
Valeur utilisée pour mettre à l’échelle une valeur logique vers une valeur physique.
count
Nombre d’éléments de données contenus dans le rapport.
physicalMinimum
LogicalMinimum exprimé en unités physiques (converti en multipliant logicalMinimum par exposant).
physicalMaximum
LogicalMaximum exprimé en unités physiques (converti en multipliant logicalMaximum par exposant).
Remarques
Le groupe de travail HID publie un ensemble de documents qui composent les tables d’utilisation HID (dictionnaire qui décrit ce que les appareils HID sont autorisés à faire). Ces tables d’utilisation HID contiennent une liste avec des descriptions d’utilisation. Une utilisation fournit des informations à un développeur d’applications sur la signification et l’utilisation prévues d’un élément particulier décrit dans le descripteur de rapport. Par exemple, une utilisation est définie pour le bouton gauche d’une souris. Le descripteur de rapport peut définir où, dans un rapport, une application peut trouver l’état actuel du bouton gauche de la souris. Les tables d’utilisation sont divisées en plusieurs espaces de noms, appelés Pages d’utilisation. Chaque page d’utilisation décrit un ensemble d’utilisations connexes pour vous aider à organiser le document. La combinaison d’une page d’utilisation et d’une utilisation définit l’ID d’utilisation qui identifie de manière unique une utilisation spécifique dans les tables d’utilisation.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1809 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server [applications de bureau uniquement] |
| En-tête | winuser.h |