IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

Artikel
02/07/2025

Die IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION Anforderung ruft Informationen über die USB-Port-Supergeschwindigkeitsspur ab.

Clienttreiber müssen diese IOCTL an einer IRQL von PASSIVE_LEVEL senden.

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION ist eine Benutzermodus-E/A-Steuerelementanforderung. Diese Anforderung richtet sich an das USB-Hubgerät (GUID_DEVINTERFACE_USB_HUB).

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabe-/Ausgabepuffer

Sowohl Eingabe- als auch Ausgabepuffer verweisen auf eine vom Aufrufer zugewiesene USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION Struktur. Bei eingaben muss das ConnectionIndex-Element dieser Struktur eine Zahl enthalten, die größer oder gleich 1 ist, die die Anzahl des Ports angibt, deren Informationen zur Supergeschwindigkeitsspur gemeldet werden sollen. Der Hubfahrer gibt in den übrigen Mitgliedern der USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION Struktur Informationen zur Supergeschwindigkeitsspur zurück. Das IRP, das AssociatedIrp.SystemBuffer Member verweist auf die USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION Struktur.

Bei der Ausgabe empfängt die USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION Struktur Informationen über die angegebenen Supergeschwindigkeitsspuren vom USB-Hubtreiber.

Länge des Eingabe-/Ausgabepuffers

Die Größe einer USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION 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.

Bemerkungen

Hier ist ein Beispiel, das zeigt, wie Die Informationen zum USB-Port der Supergeschwindigkeitsspur abgerufen werden.

success = DeviceIoControl(hHubDevice,
                          IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION,
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          connectionSSPInfo,
                          sizeof(USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION),
                          &nBytes,
                          NULL);

Anforderungen

Anforderung	Wert
Header-	usbioctl.h

Freigeben über