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

IRP_MJ_DEVICE_CONTROL

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)

Weitere Informationen

USB_HUB_INFORMATION_EX