IOCTL_USB_GET_NODE_CONNECTION_NAME IOCTL (usbioctl.h)
Die IOCTL_USB_GET_NODE_CONNECTION_NAME E/A-Steuerelementanforderung wird mit der USB_NODE_CONNECTION_NAME Struktur verwendet, um den symbolischen Verknüpfungsnamen des Hubs abzurufen, der an den nachgeschalteten Port angefügt ist.
IOCTL_USB_GET_NODE_CONNECTION_NAME ist eine Benutzermodus-E/A-Steuerelementanforderung. Diese Anforderung richtet sich an das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB).
Hauptcode
Eingabepuffer
Der AssociatedIrp.SystemBuffer Member verweist auf eine USB_NODE_CONNECTION_NAME Struktur. Bei eingaben muss das ConnectionIndex- Mitglied dieser Struktur die Nummer des Ports angeben, der auf einen angefügten Hub überprüft werden soll.
Eingabepufferlänge
Die Größe einer USB_NODE_CONNECTION_NAME Struktur.
Ausgabepuffer
AssociatedIrp.SystemBuffer verweist auf eine USB_NODE_CONNECTION_NAME Struktur. Bei der Ausgabe enthält diese Struktur den symbolischen Namen des angefügten Hubs im HubName Member. Wenn kein Hub angefügt ist, verfügt der Hub nicht über eine symbolische Verbindung, oder das angeschlossene Gerät ist kein Hub, HubName-[0] enthält einen Wert von UNICODE_NULL.
Länge des Ausgabepuffers
Das Parameters.DeviceIoControl.OutputBufferLength Member enthält die Größe der gesamten USB_NODE_CONNECTION_NAME Struktur in Byte.
Statusblock
Der USB-Stapel legt Irp->IoStatus.Status auf STATUS_SUCCESS fest, wenn die Anforderung erfolgreich ist. Die Anforderung meldet erfolglos, auch wenn kein Hub angefügt ist, hat der angefügte Hub keine symbolische Verbindung, oder das angeschlossene Gerät ist kein Hub.
Andernfalls legt der USB-Stapel Status auf die entsprechende Fehlerbedingung fest, z. B. STATUS_INVALID_PARAMETER oder STATUS_INSUFFICIENT_RESOURCES.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | usbioctl.h (include Usbioctl.h) |