IOCTL_USB_GET_HUB_CAPABILITIES_EX IOCTL (usbioctl.h)
Die IOCTL_USB_GET_HUB_CAPABILITIES_EX E/A-Steuerungsanforderung ruft die Funktionen eines USB-Hubs ab.
IOCTL_USB_GET_HUB_CAPABILITIES_EX ist eine E/A-Steuerungsanforderung für den Benutzermodus. Diese Anforderung zielt auf das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB) ab.
Hauptcode
Eingabepuffer
Das AssociatedIrp.SystemBuffer-Element verweist auf einen vom Benutzer zugewiesenen Puffer.
Länge des Eingabepuffers
Die Pufferlänge ist sizeof(USB_HUB_CAPABILITIES_EX)gleich .
Ausgabepuffer
AssociatedIrp.SystemBuffer verweist auf eine vom Benutzer zugewiesene USB_HUB_CAPABILITIES_EX-Struktur . In der Ausgabe beschreibt diese Struktur die Hubfunktionen.
Länge des Ausgabepuffers
Das Parameters.DeviceIoControl.OutputBufferLength-Element gibt die Größe der Daten in Bytes an, die bei SystemBuffer oder sizeof(USB_HUB_CAPABILITIES_EX)zurückgegeben werden.
Statusblock
Der USB-Stapel legt Irp-IoStatus.Status> auf STATUS_SUCCESS fest, wenn die Anforderung erfolgreich ist. Andernfalls legt der USB-Stapel Status auf die entsprechende Fehlerbedingung fest, z. B. STATUS_INVALID_PARAMETER oder STATUS_INSUFFICIENT_RESOURCES. Wenn der Hub nicht gestartet wurde oder nicht funktioniert, gibt die Anforderung STATUS_UNSUCCESSFUL zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista und höher. |
| Kopfzeile | usbioctl.h (include Usbioctl.h) |