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 zu einem 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 zugehörigen Hubdeskriptoren ab, wie in USB 2.0 bzw. 3.0-Spezifikationen definiert.
IOCTL_USB_GET_HUB_INFORMATION_EX ist eine E/A-Steuerungsanforderung im Benutzermodus. Diese Anforderung richtet sich an das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB).
Hauptcode
Eingabepuffer
AssociatedIrp.SystemBuffer verweist auf eine vom Aufrufer zugewiesene USB_HUB_INFORMATION_EX-Struktur .
Eingabepufferlänge
Das Parameters.DeviceIoControl.InputBufferLength-Element gibt die Größe des vom Aufrufer zugewiesenen Puffers in Bytes an, dessen Größe gleich ist sizeof(USB_HUB_INFORMATION_EX).
Ausgabepuffer
Bei der Ausgabe wird die USB_HUB_INFORMATION_EX-Struktur , auf die von AssociatedIrp.SystemBuffer verwiesen wird, mit Informationen zum Hub gefüllt.
Länge des Ausgabepuffers
Das Parameters.DeviceIoControl.OutputBufferLength-Element gibt die Größe des Ausgabepuffers SystemBuffer in Bytes 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Kopfzeile | usbioctl.h (include Usbioctl.h) |