HID-Verwendungen

HID-Verwendungen identifizieren die beabsichtigte Verwendung von HID-Steuerelementen und das, was die Steuerelemente tatsächlich messen.

Die folgenden Konzepte und Terminologie werden in der HID-Dokumentation im WDK verwendet:

Seite "Verwendung"

Verwendungs-ID

Erweiterte Nutzung

Verwendungsbereich

Aliasverwendungen

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 werden.

Weitere Informationen zum Ermitteln der Verwendungen, die von einem HIDClass-Gerät unterstützt werden, finden Sie unter:

Sammlungsfunktion

Schaltflächenfunktionsarrays

Wertefunktionsarrays

Interpretieren von HID-Berichten

Ausführliche Informationen zur Verwendung von HID nach Industriestandard finden Sie in der USB-Spezifikation (Universal Serial Bus) HID Usage Tables auf der Website des USB Implementers Forum .

Seite "Verwendung"

HID-Verwendungen sind in Nutzungsseiten verwandter Steuerelemente organisiert. Eine bestimmte Steuerelementnutzung wird durch die Zugehörige Nutzungsseite, eine Nutzungs-ID, einen Namen und eine Beschreibung definiert. Ein Nutzungsseitenwert ist ein 16-Bit-Wert ohne Vorzeichen.

Beispiele für Nutzungsseiten 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 Schaltfläche HID_USAGE_PAGE_BUTTON

Verwendungs-ID

Im Kontext einer Nutzungsseite gibt ein gültiger Nutzungsbezeichner oder eine Nutzungs-ID eine Verwendung auf einer Nutzungsseite an. Eine Nutzungs-ID von 0 (null) ist reserviert. Ein Nutzungs-ID-Wert ist ein 16-Bit-Wert ohne Vorzeichen.

Beispiele für Steuerelemente, die auf der Seite Verwendung generischer 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 GamePad HID_USAGE_GENERIC_GAMEPAD
0x06 Tastatur HID_USAGE_GENERIC_KEYBOARD
0x07 Keypad HID_USAGE_GENERIC_KEYPAD
0x08 Controller mit mehreren Achsen HID_USAGE_GENERIC_MULTI_AXIS_CONTROLLER

Erweiterte Nutzung

Eine erweiterte Verwendung ist ein 32-Bit-Wert, der einen 16-Bit-Nutzungsseitenwert in den wichtigsten zwei Bytes und eine 16-Bit-Nutzungs-ID in den am wenigsten signifikanten zwei Bytes des erweiterten Nutzungswerts angibt.

Verwendungsbereich

Ein Nutzungsbereich ist ein inklusiver, aufeinander folgender Bereich von Nutzungs-IDs, die sich alle auf derselben Nutzungsseite befinden. Ein Verwendungsbereich wird durch Elemente für den Mindestverbrauch und die maximale Nutzung in einem Berichtsdeskriptor angegeben.

Aliasverwendungen

Für eine Linksammlung oder ein HID-Steuerelement können mehrere Verwendungen angegeben werden. Für eine bestimmte Sammlung oder ein bestimmtes Steuerelement sind eine Gruppe solcher Verwendungen Aliase füreinander und werden als Aliasverwendungen bezeichnet. Trennzeichenelemente werden verwendet, um Aliasverwendungen anzugeben. Verwendungsbereiche können nicht als Alias verwendet werden.

Informationen dazu, wie Aliasverwendungen in den Funktionsarrays einer Sammlung der obersten Ebene angegeben werden, finden Sie unter Schaltflächenfunktionsarrays und Wertfunktionsarrays.