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
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) |