Initialisieren von HID-Berichten

In diesem Artikel wird beschrieben, wie Benutzermodusanwendungen und Kernelmodustreiber einen HID-Bericht initialisieren, bevor sie die HIDClass-Supportroutinen oder die IOCTLs des HID-Klassentreibers verwenden.

Zum Initialisieren eines Berichtspuffers erstellt eine Anwendung oder ein Treiber einen null initialisierten Puffer der erforderlichen Größe (in Bytes) für den Berichtstyp. Die Xxx ReportByteLength-Elemente der HIDP_CAPS Struktur einer HID-Auflistung geben die erforderliche Größe von Eingabe-, Ausgabe- und Featureberichten an. Nach der Initialisierung eines Berichtspuffers kann eine Anwendung oder ein Treiber HidP_SetXxx-Routinen verwenden, um Steuerdaten im Bericht festzulegen. Bei der ersten Verwendung eines Berichts legen die HidP_SetXxx-Routinen die Berichts-ID auf die berichts-ID fest, die einer angegebenen HID-Verwendung zugeordnet ist. Wenn die Anwendung oder der Treiber anschließend versucht, eine Verwendung festzulegen, die mit der Berichts-ID nicht kompatibel ist, geben die HidP_SetXxx-Routinen einen Status von HIDP_STATUS_INCOMPATIBLE_REPORT_ID zurück.