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

IRP_MJ_DEVICE_CONTROL

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)

Weitere Informationen

USB_ROOT_HUB_NAME