HID-Verwendungen
HID-Verwendungen identifizieren die beabsichtigte Verwendung von HID-Steuerelementen und was die Steuerelemente tatsächlich messen.
Die folgenden Konzepte und Terminologie werden in der HID-Dokumentation im WDK verwendet:
Spezifische Beispiele für Verwendungen, auf die Windows-Komponenten zugreifen, finden Sie unter "Sammlungen der obersten Ebene", die von Windows für die Systemverwendung geöffnet wurden.
Weitere Informationen zum Ermitteln der Verwendungen, die ein HIDClass-Gerät unterstützt, finden Sie unter:
- Sammlungsfunktion
- Schaltflächenfunktionsarrays
- Wertefunktionsarrays
- Interpretieren von HID-Berichten
Ausführliche Informationen zur HID-Standardverwendung finden Sie auf der Website des USB Implementers Forums zur HID-Spezifikation(Universal Serial Bus).
Verwendungsseite
HID-Verwendungen sind in Verwendungsseiten verwandter Steuerelemente angeordnet. Eine bestimmte Steuerelementverwendung wird durch die Verwendungsseite, eine Verwendungs-ID, einen Namen und eine Beschreibung definiert. Ein Verwendungsseitenwert ist ein 16-Bit-Wert ohne Vorzeichen.
Beispiele für Verwendungsseiten sind:
| Seiten-ID | Seitenname | hidusage.h-Konstante |
|---|---|---|
| 0x01 | Generische Desktopsteuerelemente | HID_USAGE_PAGE_GENERIC |
| 0x05 | Spielsteuerelemente | HID_USAGE_PAGE_GAME |
| 0x08 | LEDs | HID_USAGE_PAGE_LED |
| 0x09 | Taste | HID_USAGE_PAGE_BUTTON |
Verwendungs-ID
Im Kontext einer Verwendungsseite gibt ein gültiger Verwendungsbezeichner oder eine Verwendungs-ID eine Verwendungsseite an. Eine Verwendungs-ID von Null ist reserviert. Ein Verwendungs-ID-Wert ist ein nicht signierter 16-Bit-Wert.
Beispiele für Steuerelemente, die auf der Verwendungsseite für allgemeine Desktopsteuerelemente aufgeführt sind:
| Verwendungs-ID | Verwendungsname | hidusage.h-Konstante |
|---|---|---|
| 0x01 | Zeiger | HID_USAGE_GENERIC_POINTER |
| 0x02 | Maus | HID_USAGE_GENERIC_MOUSE |
| 0x04 | Joystick | HID_USAGE_GENERIC_JOYSTICK |
| 0x05 | Game Pad | HID_USAGE_GENERIC_GAMEPAD |
| 0x06 | Tastatur | HID_USAGE_GENERIC_KEYBOARD |
| 0x07 | Keypad | HID_USAGE_GENERIC_KEYPAD |
| 0x08 | Mehrachsencontroller | HID_USAGE_GENERIC_MULTI_AXIS_CONTROLLER |
Erweiterte Nutzung
Eine erweiterte Verwendung ist ein 32-Bit-Wert, der einen 16-Bit-Verwendungsseitenwert in den wichtigsten zwei Bytes und eine 16-Bit-Verwendungs-IDin den geringsten zwei Bytes des erweiterten Verwendungswerts angibt.
Verwendungsbereich
Ein Verwendungsbereich ist ein inklusiver, aufeinander folgender Bereich von Verwendungs-IDs, die sich alle auf derselben Verwendungsseite befinden. Ein Verwendungsbereich wird durch mindeste und maximale Verwendungshöchstwerte in einem Berichtsdeskriptor angegeben.
Aliasverwendungen
Für eine Verknüpfungssammlung oder ein HID-Steuerelement können mehrere Verwendungen angegeben werden. Bei einer bestimmten Sammlung oder einem Bestimmten Steuerelement sind eine Gruppe solcher Verwendungen Aliase voneinander und werden als aliasierte Verwendungen bezeichnet. Trennzeichenelemente werden verwendet, um aliasierte Verwendungen anzugeben. Verwendungsbereiche können nicht aliasiert werden.
Informationen dazu, wie aliasbasierte Verwendungen in den Funktionsarrays einer Auflistung auf oberster Ebene angegeben werden, finden Sie unter Button Capability Arrays und Value Capability Arrays.