IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)
Die IOCTL_USB_GET_ROOT_HUB_NAME E/A-Steuerungsanforderung wird mit der USB_ROOT_HUB_NAME-Struktur verwendet, um den symbolischen Linknamen des Stammhubs abzurufen.
IOCTL_USB_GET_ROOT_HUB_NAME ist eine E/A-Steuerungsanforderung im Benutzermodus. Diese Anforderung zielt auf den USB-Hostcontroller (GUID_DEVINTERFACE_USB_HOST_CONTROLLER) ab.
Hauptcode
Eingabepuffer
Keine.
Länge des Eingabepuffers
Keine.
Ausgabepuffer
Bei der Ausgabe zeigt der AssociatedIrp.SystemBuffer-Member auf eine USB_ROOT_HUB_NAME-Struktur , die den symbolischen Linknamen des Stammhubs enthält. Der führende "\xxx\"-Text ist nicht in der abgerufenen Zeichenfolge enthalten.
Länge des Ausgabepuffers
Die Größe einer USB_ROOT_HUB_NAME-Struktur .
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 Stammhub entfernt oder beendet wird, gibt die Anforderung STATUS_SUCCESS zurück, aber die Zeichenfolge ist NULL.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | usbioctl.h (include Usbioctl.h) |