HID-Anwendungsprogrammierschnittstelle (API)
Es gibt drei Kategorien von HID-APIs:
- Geräteermittlung und -einrichtung
- Datenverschiebung
- Erstellen und Interpretieren von Berichten
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.
- HidD_GetAttributes
- HidD_GetHidGuid
- HidD_GetIndexedString
- HidD_GetManufacturerString
- HidD_GetPhysicalDescriptor
- HidD_GetPreparsedData
- HidD_GetProductString
- HidD_GetSerialNumberString
- HidD_GetNumInputBuffers
- HidD_SetNumInputBuffers
Datenverschiebung
Die folgenden HID-APIs werden verwendet, um Daten zwischen einer Anwendung und einem ausgewählten Gerät zu verschieben.
Erstellen und Interpretieren von Berichten
Entwickler von benutzerdefinierter Hardware kennen die Größe und das Format jedes Berichts, der von ihrem Gerät ausgegeben wird. In diesem Fall kann die Anwendung die Eingabe- und Ausgabeberichtpuffer als Struktur umwandeln und die Daten nutzen.
Entwickler von HID-Anwendungen, die mit allen Geräten kommunizieren möchten, die allgemeine Funktionen verfügbar machen, kennen möglicherweise nicht die Größe und das Format der HID-Berichte. Diese Anwendungskategorie versteht bestimmte Auflistungen der obersten Ebene und bestimmte Verwendungen.
Zum Interpretieren der von einem Gerät empfangenen Berichte oder zum Erstellen von Berichten, die die Anwendung senden soll, muss der Berichtsdeskriptor verwendet werden, um festzustellen, ob und wo sich eine bestimmte Verwendung in den Berichten und den Werteneinheiten in den Berichten befindet. In diesen Fällen ist die HID-Analyse erforderlich. Windows stellt einen HID-Parser für die Verwendung durch Treiber und Anwendungen über APIs (HidP_*) bereit, die verwendet werden können, um die von einem Gerät unterstützten Verwendungstypen zu ermitteln, den Status dieser Verwendungen in einem Bericht zu bestimmen oder einen Bericht zu erstellen, um den Status einer Verwendung auf dem Gerät zu ändern.
Hier ist die Liste der HID-Parser-APIs:
- HidP_GetButtonArray
- HidP_GetButtonCaps
- HidP_GetButtons
- HidP_GetButtonsEx
- HidP_GetCaps
- HidP_GetData
- HidP_GetExtendedAttributes
- HidP_GetLinkCollectionNodes
- HidP_GetScaledUsageValue
- HidP_GetSpecificButtonCaps
- HidP_GetSpecificValueCaps
- HidP_GetUsages
- HidP_GetUsagesEx
- HidP_GetUsageValue
- HidP_GetUsageValueArray
- HidP_GetValueCaps
- HidP_GetVersion
- HidP_InitializeReportForID
- HidP_MaxDataListLength
- HidP_MaxUsageListLength
- HidP_SetButtonArray
- HidP_SetButtons
- HidP_SetData
- HidP_SetScaledUsageValue
- HidP_SetUsages
- HidP_SetUsageValue
- HidP_SetUsageValueArray
- HidP_TranslateUsagesToI8042ScanCodes
- HidP_UnsetButtons
- HidP_UnsetUsages
- HidP_UsageAndPageListDifference
- HidP_UsageListDifference