IOCTL_GET_PHYSICAL_DESCRIPTOR IOCTL (hidclass.h)

Die IOCTL_GET_PHYSICAL_DESCRIPTOR Anforderung ruft den physischen Deskriptor einer Auflistung auf oberster Ebeneab. Bei einem Minidriver ist dieser Deskriptor der Deskriptor des HIDClass-Geräts.

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

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Parameters.DeviceIoControl.OutputBufferLength- an der I/O-Stapelposition des IRP gibt die Größe des Ausgabepuffers in Bytes an.

Ausgabepuffer

Irp->MdlAddress- muss auf den Puffer verweisen, der den physischen Deskriptor empfängt.

Der HID-Minidriver kopiert den physischen Deskriptor bei Irp->UserBuffer-in den Benutzerpuffer.

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.

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

  • Information wird 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 entsprechenden NTSTATUS-Fehlercode festgelegt.
HID-Minidriver, die andere Treiber mit diesem IRP aufrufen, um die E/A auf ihrem Gerät auszuführen, sollten sicherstellen, dass das Information Feld des Statusblocks korrekt ist und den Inhalt des felds Status nicht ändert.

Anforderungen

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

Siehe auch

HidD_GetPhysicalDescriptor

  • Last updated on