USAGE_PROPERTIES-Struktur (winuser.h)

  • Artikel

Enthält Geräteeigenschaften (globale HID-Elemente (Human Interface Device, HID), die HID-Verwendungen entsprechen) für jeden Typ von HID-Eingabegeräten.

Syntax

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;

Member

level

Ein nutzungsspezifischer Wert für ein bereichsbasiertes lineares Steuerelement (Regler oder Wähl), ein Ein-/Aus-Steuerelement (Umschaltschalter), ein momentäres Steuerelement (Maustaste), ein One-Shot-Steuerelement (Schaltfläche, die ein einzelnes Ereignis auslöst) oder ein erneutes Auslösen des Steuerelements (Schaltfläche, die ein wiederholtes Ereignis auslöst).

page

Die Nutzungsseiten-ID, z. B. VR Controls Page (0x03) oder Game Controls Page (0x05).

usage

Die Nutzungs-ID, die einer Nutzungsseite zugeordnet ist, z. B. Rechts/Links drehen (21) oder Rechts/Links bewegen (24) für eine Seite mit Spielsteuerelementen.

logicalMinimum

Der kleinste Wert, den das Steuerelement melden kann.

logicalMaximum

Der größte Wert, den das Steuerelement melden kann.

unit

Der Standard des Measures, der verwendet wird, um den physischen Wert eines Steuerelements zu beschreiben (nach der Konvertierung des logischen Werts mithilfe des Exponentenwerts ). Die HID-Spezifikation definiert Codes für die Grundeinheiten Länge, Masse, Zeit, Temperatur, Strom und Lichtstärke.

exponent

Der Wert, der verwendet wird, um einen logischen Wert auf einen physischen Wert zu skalieren.

count

Die Anzahl der im Bericht enthaltenen Datenelemente.

physicalMinimum

Das logicalMinimum , ausgedrückt in physischen Einheiten (konvertiert durch Multiplikation von logicalMinimum mit Exponent).

physicalMaximum

Das logicalMaximum , ausgedrückt in physischen Einheiten (konvertiert durch Multiplikation von logicalMaximum mit Exponent).

Hinweise

Die HID-Arbeitsgruppe veröffentlicht eine Reihe von Dokumenten, aus denen die HID-Verwendungstabellen bestehen (das Wörterbuch, das beschreibt, was HID-Geräte tun dürfen). Diese HID-Verwendungstabellen enthalten eine Liste mit Nutzungsbeschreibungen. Eine Verwendung stellt einem Anwendungsentwickler Informationen über die beabsichtigte Bedeutung und Verwendung eines bestimmten Elements bereit, das im Berichtsdeskriptor beschrieben wird. Beispielsweise ist für die linke Schaltfläche einer Maus eine Verwendung definiert. Der Berichtsdeskriptor kann definieren, wo in einem Bericht eine Anwendung den aktuellen Zustand der linken Maustaste finden kann. Die Verwendungstabellen sind in mehrere Namensräume unterteilt, die als Nutzungsseiten bezeichnet werden. Jede Verwendungsseite beschreibt eine Reihe verwandter Verwendungen, um das Dokument zu organisieren. Die Kombination aus Nutzungsseite und Nutzung definiert die Verwendungs-ID, die eine bestimmte Verwendung in den Verwendungstabellen eindeutig identifiziert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server [nur Desktop-Apps]
Kopfzeile winuser.h

Weitere Informationen

Universal Serial Bus HID-Verwendungstabellen – USB.org