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
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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Keine unterstützt |
| Header- | usbioctl.h (include Usbioctl.h) |