IOCTL_HID_READ_REPORT IOCTL (hidport.h)

Artikel
02/26/2024

Die IOCTL_HID_READ_REPORT Anforderung überträgt einen Eingabebericht von einem HIDClass-Gerät in den Puffer des HID-Klassentreibers.

Allgemeine Informationen zu HIDClass-Geräten finden Sie unter HID-Sammlungen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Parameters.DeviceIoControl.OutputBufferLength enthält die Größe des Puffers, der unter Irp-UserBuffer> bereitgestellt wird.

Länge des Eingabepuffers

Die Größe von OutputBufferLength

Ausgabepuffer

HID-Minidriver füllt den vom Irp-UserBuffer> auf das System verweisenden Puffer mit den vom Gerät abgerufenen Berichtsdaten aus.

Länge des Ausgabepuffers

Die Größe des UserBuffers.

Statusblock

HID-Minitreiber, die die E/A an das Gerät ausführen, legen die folgenden Felder von Irp-IoStatus> fest:

Informationen werden auf die Anzahl der vom Gerät übertragenen Bytes festgelegt.
Status wird auf STATUS_SUCCESS festgelegt, wenn die Übertragung ohne Fehler abgeschlossen wurde. Andernfalls wird er auf einen geeigneten NTSTATUS-Fehlercode festgelegt.

HID-Minitreiber, die andere Treiber mit diesem IRP aufrufen, um die E/A auf ihrem Gerät auszuführen, sollten sicherstellen, dass das Feld Information des status blocks korrekt ist und den Inhalt des Felds Status nicht ändern.

Hinweise

IOCTL_HID_READ_REPORT wird in der Regel zum kontinuierlichen Ausfüllen von Eingabeberichten verwendet, die vom Gerät gesendet werden. Diese IOCTL wird vom HID-Klassentreiber (HIDCLASS) auf Ping-Pong-Weise gesendet. Anders ausgedrückt: Sobald eine Anforderung erfüllt (abgeschlossen) ist, kann eine andere anforderung an das Gerät gesendet werden, was eine kontinuierliche Berichterstellung von Daten ermöglicht. Dies ist ein "asynchroner" Mechanismus, sodass das Gerät ihn beispielsweise verwenden kann, um Daten an den Host zu senden, was Änderungen am Zustand betrifft, wenn diese Änderungen auftreten.