IOCTL_USB_GET_HUB_INFORMATION_EX IOCTL (usbioctl.h)

Die IOCTL_USB_GET_HUB_INFORMATION_EX E/A-Steuerungsanforderung wird von einer Anwendung gesendet, um Informationen über einen USB-Hub in einer USB_HUB_INFORMATION_EX-Struktur abzurufen.

Die Anforderung ruft die höchste Portnummer auf dem Hub ab. Für USB 2.0- und SuperSpeed-Hubs (Nicht-Root-Hubs) ruft die Anforderung auch die zugeordneten Hubdeskriptoren ab, wie in usb 2.0- und 3.0-Spezifikationen definiert.

IOCTL_USB_GET_HUB_INFORMATION_EX ist eine Benutzermodus-E/A-Steuerelementanforderung. Diese Anforderung richtet sich an das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB).

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

AssociatedIrp.SystemBuffer verweist auf eine vom Aufrufer zugeordnete USB_HUB_INFORMATION_EX Struktur.

Eingabepufferlänge

Das Parameters.DeviceIoControl.InputBufferLength Member gibt die Größe des vom Aufrufer zugewiesenen Puffers in Bytes an, dessen Größe sizeof(USB_HUB_INFORMATION_EX)entspricht.

Ausgabepuffer

Bei der Ausgabe wird die USB_HUB_INFORMATION_EX Struktur, auf die AssociatedIrp.SystemBuffer verweist, mit Informationen zum Hub gefüllt.

Länge des Ausgabepuffers

Das Parameters.DeviceIoControl.OutputBufferLength Member gibt die Größe des Ausgabepuffers in Bytes SystemBuffer-an.

Statusblock

Der USB-Stapel legt Irp->IoStatus.Status auf STATUS_SUCCESS fest, wenn die Anforderung erfolgreich ist. Andernfalls legt der USB-Treiberstapel Status auf die entsprechende Fehlerbedingung fest, z. B. STATUS_INVALID_PARAMETER oder STATUS_INSUFFICIENT_RESOURCES.

Anforderungen

Siehe auch

USB_HUB_INFORMATION_EX