HID Application Programming Interface (API)

  • Artikel

Es gibt drei Kategorien von HID-APIs: Geräteermittlung und -einrichtung, Datenverschiebung und Berichtserstellung/-interpretation.

Geräteermittlung und -einrichtung

Diese HID-APIs werden verwendet, um die Eigenschaften eines HID-Geräts zu identifizieren und die Kommunikation mit diesem Gerät herzustellen. Anwendungen verwenden diese APIs, um eine Sammlung der obersten Ebene zu identifizieren.

Datenverschiebung

Diese HID-APIs werden verwendet, um Daten zwischen einer Anwendung und einem ausgewählten Gerät zu verschieben.

Berichterstellung und -interpretation

Entwickler von benutzerdefinierter Hardware kennen die Größe und das Format der einzelnen Berichte, die von ihrem Gerät ausgestellt werden. In diesem Fall kann die Anwendung die Eingabe- und Ausgabeberichtspuffer in Strukturen umwandeln und die Daten nutzen.

Entwickler von HID-Anwendungen, die mit allen Geräten kommunizieren sollen, die allgemeine Funktionen verfügbar machen (z. B. eine Musikanwendung, die erkennen muss, wenn eine Wiedergabeschaltfläche gedrückt wird), kennen möglicherweise nicht die Größe und das Format der HID-Berichte. Diese Kategorie von Anwendungen kennt bestimmte Sammlungen der obersten Ebene und bestimmte Verwendungen.

Um die von einem Gerät empfangenen Berichte zu interpretieren oder zu sendende Berichte zu erstellen, muss die Anwendung den Berichtsdeskriptor verwenden, um zu bestimmen, ob und wo sich eine bestimmte Verwendung in den Berichten befindet, und (möglicherweise) die Werteeinheiten in den Berichten. In diesen Fällen ist eine HID-Analyse erforderlich. Windows stellt einen HID-Parser für die Verwendung durch Treiber und Anwendungen über APIs (HidP_*) bereit, der verwendet werden kann, um die von einem Gerät unterstützten Nutzungsarten zu ermitteln, den Zustand solcher Verwendungen in einem Bericht zu bestimmen oder einen Bericht zu erstellen, um den Zustand einer Nutzung auf dem Gerät zu ändern.

Dies sind die HID-Parser-APIs.