IOCTL_HID_GET_COLLECTION_INFORMATION IOCTL (hidclass.h)

Die IOCTL_HID_GET_COLLECTION_INFORMATION-Anforderung ruft die HID_COLLECTION_INFORMATION-Struktur einer Auflistung der obersten Ebene ab. Diese Informationen umfassen die Größe der vorbereiteten Daten einer Sammlung in Byte.

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

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Parameters.DeviceIoControl.OutputBufferLength in der E/A-Stapelposition des IRP gibt die Größe des Ausgabepuffers in Bytes an, die = sizeof(HID_COLLECTION_INFORMATION) sein >muss.

Länge des Eingabepuffers

Größer als oder gleich sizeof(HID_COLLECTION_INFORMATION).

Ausgabepuffer

Irp->AssociatedIrp.SystemBuffer verweist auf einen Puffer, der die Sammlungsinformationen empfängt. Diese Daten werden im vom Anforderer bereitgestellten Puffer als HID_COLLECTION_INFORMATION-Struktur formatiert.

Länge des Ausgabepuffers

Die Größe einer HID_COLLECTION_INFORMATION-Struktur.

Statusblock

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

  • Informationen werden auf sizeof(HID_COLLECTION_INFORMATION) festgelegt, wenn die Daten erfolgreich abgerufen wurden.
  • Status wird auf STATUS_SUCCESS festgelegt, wenn die Übertragung ohne Fehler abgeschlossen wurde. Andernfalls wird er auf einen geeigneten NTSTATUS-Fehlercode festgelegt.

Anforderungen

Anforderung Wert
Header hidclass.h (include Hidclass.h)

Weitere Informationen

HID_COLLECTION_INFORMATION