IOCTL_GET_PHYSICAL_DESCRIPTOR IOCTL (hidclass.h)

Die IOCTL_GET_PHYSICAL_DESCRIPTOR Anforderung ruft den physischen Deskriptor einer Auflistung der obersten Ebene ab. Bei einem Minidriver ist dieser Deskriptor der Deskriptor des HIDClass-Geräts.

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.

Ausgabepuffer

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

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

Statusblock

Der HID-Klassentreiber legt das Statusmitglied von Irp-IoStatus> auf STATUS_SUCCESS fest, wenn die Übertragung ohne Fehler abgeschlossen wurde. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode festgelegt.

HID-Miniantriebe, die die E/A zum Gerät ausführen, legen die folgenden Felder von Irp-IoStatus> fest:

• Informationen sind auf die Anzahl der vom Gerät übertragenen Bytes festgelegt.
• Der Status wird auf STATUS_SUCCESS festgelegt, wenn die Übertragung ohne Fehler abgeschlossen wurde. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode festgelegt.

HID-Minitreiber, die andere Treiber mit diesem IRP aufrufen, um die E/A auf ihrem Gerät auszuführen, sollten sicherstellen, dass das Feld Information des status blocks richtig ist, und den Inhalt des Felds Status nicht ändern.

Anforderungen

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

Weitere Informationen

HidD_GetPhysicalDescriptor