IOCTL_HID_SET_POLL_FREQUENCY_MSEC IOCTL (hidclass.h)

Die IOCTL_HID_SET_POLL_FREQUENCY_MSEC-Anforderung legt die Abrufhäufigkeit in Millisekunden für eine Auflistung auf oberster Ebenefest.

Benutzermodusanwendungen oder Kernelmodustreiber, die unregelmäßige, opportunistische Lesevorgänge auf einem abgefragten Gerät ausführen, müssen ein Abrufintervall von Null bereitstellen. In solchen Fällen ändert IOCTL_HID_SET_POLL_FREQUENCY_MSEC nicht tatsächlich die Abrufhäufigkeit des Geräts; Wenn die Berichtsdaten beim Lesen jedoch nicht veraltet sind, wird das Lesen sofort mit den neuesten Berichtsdaten für die angegebene Sammlung abgeschlossen. Wenn die Berichtsdaten veraltet sind, wird sie sofort aktualisiert, ohne auf den Ablauf des Abrufintervalls zu warten und das Lesen mit den neuen Daten abgeschlossen wird.

Wenn der Wert für das Abfrageintervall, das im IRP angegeben ist, nicht null ist, muss er >= MIN_POLL_INTERVAL_MSEC und <= MAX_POLL_INTERVAL_MSEC sein.

Die Abfrage kann eingeschränkt sein, wenn mehrere Auflistungen auf oberster Ebene vorhanden sind.

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

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Parameters.DeviceIoControl.InputBufferLength- an der I/O-Stapelposition des IRP gibt die Größe des Eingabepuffers in Bytes an, die >= Sizeof(ULONG) sein muss.

Irp->AssociatedIrp.SystemBuffer enthält das neue Abrufintervall.

Eingabepufferlänge

Ein Wert größer oder gleich Größe von(ULONG).

Ausgabepuffer

Nichts.

Länge des Ausgabepuffers

Nichts.

Statusblock

Der HID-Klassentreiber legt den Status Member von Irp->IoStatus- auf STATUS_SUCCESS fest, wenn die Übertragung ohne Fehler abgeschlossen wurde. Andernfalls wird er auf einen entsprechenden NTSTATUS-Fehlercode festgelegt.

Anforderungen

Siehe auch

IOCTL_HID_GET_POLL_FREQUENCY_MSEC