IOCTL_USB_GET_ROOT_HUB_NAME IOCTL (usbioctl.h)
Die IOCTL_USB_GET_ROOT_HUB_NAME E/A-Steuerelementanforderung wird mit der USB_ROOT_HUB_NAME Struktur verwendet, um den symbolischen Verknüpfungsnamen des Stammhubs abzurufen.
IOCTL_USB_GET_ROOT_HUB_NAME ist eine Benutzermodus-E/A-Steuerelementanforderung. Diese Anforderung richtet sich an den USB-Hostcontroller (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).
Hauptcode
Eingabepuffer
Nichts.
Eingabepufferlänge
Nichts.
Ausgabepuffer
Bei der Ausgabe verweist das AssociatedIrp.SystemBuffer Member auf eine USB_ROOT_HUB_NAME Struktur, die den symbolischen Verknüpfungsnamen des Stammhubs enthält. Der führende Text "\xxx\" 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) |