IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION IOCTL (usbioctl.h)

Artikel
05/23/2024

Die IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION Anforderung ruft Informationen zum USB-Port-Superspeed-Spur ab.

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

IOCTL_USB_GET_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION ist eine E/A-Steuerungsanforderung im Benutzermodus. 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 zeigen auf eine aufruferseitig zugewiesene USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION-Struktur . Bei der Eingabe muss das ConnectionIndex-Element dieser Struktur eine Zahl größer oder gleich 1 enthalten, die die Anzahl des Ports angibt, dessen Spurinformationen für superschnelle Geschwindigkeit gemeldet werden sollen. Der Hubtreiber gibt In den verbleibenden Mitgliedern der USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION-Struktur Informationen zur Höchstgeschwindigkeit zurück. Das IRP, das AssociatedIrp.SystemBuffer-Element zeigt auf die USB_NODE_CONNECTION_SUPERSPEEDPLUS_INFORMATION-Struktur .

An 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.

Hinweise

Hier sehen Sie ein Beispiel, das zeigt, wie Sie informationen zum USB-Port über die Supergeschwindigkeitsspur abrufen.

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