Initialisieren von HID-Berichten

In diesem Abschnitt wird beschrieben, wie Benutzermodusanwendungen und Kernelmodustreiber einen HID-Bericht initialisieren, bevor die HIDClass-Unterstützungsroutinen oder die HID-Klassentreiber-IOCTLs verwendet werden.

Um einen Berichtspuffer zu initialisieren, erstellt eine Anwendung oder ein Treiber einen nullinitialisierten Puffer der erforderlichen Größe in Bytes für den Berichtstyp. Die XxxReportByteLength-Member 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 Steuerungsdaten im Bericht festzulegen. Bei der ersten Verwendung eines Berichts legen die HidP_SetXxx-Routinen die Berichts-ID auf die-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 eine status HIDP_STATUS_INCOMPATIBLE_REPORT_ID zurück.