IOCTL_GET_NUM_DEVICE_INPUT_BUFFERS IOCTL (hidclass.h)

Die IOCTL_GET_NUM_DEVICE_INPUT_BUFFERS Anforderung ruft die Größe der Eingabeberichtswarteschlange für eine Sammlung auf oberster Ebeneab.

Die Eingabeberichtswarteschlange wird als Ringpuffer implementiert. Wenn eine Sammlung Daten schneller an den HID-Klassentreiber überträgt, als die Eingabeberichte gelesen werden, können Berichte verloren gehen. Die Größe der Eingabeberichtswarteschlange kann mithilfe von IOCTL_SET_NUM_DEVICE_INPUT_BUFFERSangepasst werden.

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

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

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

Eingabepufferlänge

Die Größe des Puffers ist Größe von(ULONG).

Ausgabepuffer

Irp->AssociatedIrp.SystemBuffer verweist auf einen Puffer, der die Größe der Berichtseingabewarteschlange erhält.

Länge des Ausgabepuffers

Die Größe des Puffers ist Größe von(ULONG).

Statusblock

Der HID-Klassentreiber legt die folgenden Felder von Irp->IoStatus-fest:

• Information wird auf Größe von(ULONG) festgelegt, wenn die Größe der Berichtseingabewarteschlange erfolgreich abgerufen wird.
• Status wird auf STATUS_SUCCESS festgelegt, wenn die Übertragung ohne Fehler abgeschlossen wurde. Andernfalls wird er auf einen entsprechenden NTSTATUS-Fehlercode festgelegt.

Anforderungen

Siehe auch

HidD_SetNumInputBuffers