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 Linknamen des Hubs abzurufen, der an den Downstreamport angefügt ist.
IOCTL_USB_GET_NODE_CONNECTION_NAME ist eine E/A-Steuerungsanforderung im Benutzermodus. Diese Anforderung richtet sich an das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB).
Hauptcode
Eingabepuffer
Das AssociatedIrp.SystemBuffer-Element verweist auf eine USB_NODE_CONNECTION_NAME-Struktur . Bei der Eingabe muss das ConnectionIndex-Element dieser Struktur die Nummer des Ports angeben, der nach einem angefügten Hub gesucht werden soll.
Eingabepufferlänge
Die Größe einer USB_NODE_CONNECTION_NAME-Struktur .
Ausgabepuffer
AssociatedIrp.SystemBuffer verweist auf eine USB_NODE_CONNECTION_NAME-Struktur . In der Ausgabe enthält diese Struktur den symbolischen Namen des angefügten Hubs im HubName-Element . Wenn kein Hub angefügt ist, der Hub keine symbolische Verbindung aufweist oder das angefügte Gerät kein Hub ist, enthält HubName[0] den Wert UNICODE_NULL.
Länge des Ausgabepuffers
Das Parameters.DeviceIoControl.OutputBufferLength-Element enthält die Größe der gesamten USB_NODE_CONNECTION_NAME Struktur in Bytes.
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, der angefügte Hub keine symbolische Verbindung aufweist oder das angefügte Gerät kein Hub ist.
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) |