USB_NODE_CONNECTION_INFORMATION Struktur (usbioctl.h)

Artikel
02/07/2025

Die USB_NODE_CONNECTION_INFORMATION Struktur wird mit der IOCTL_USB_GET_NODE_CONNECTION_INFORMATION Anforderung zum Abrufen von Informationen über einen USB-Anschluss und angeschlossenes Gerät verwendet.

Syntax

typedef struct _USB_NODE_CONNECTION_INFORMATION {
  ULONG                 ConnectionIndex;
  USB_DEVICE_DESCRIPTOR DeviceDescriptor;
  UCHAR                 CurrentConfigurationValue;
  BOOLEAN               LowSpeed;
  BOOLEAN               DeviceIsHub;
  USHORT                DeviceAddress;
  ULONG                 NumberOfOpenPipes;
  USB_CONNECTION_STATUS ConnectionStatus;
  USB_PIPE_INFO         PipeList[0];
} USB_NODE_CONNECTION_INFORMATION, *PUSB_NODE_CONNECTION_INFORMATION;

Angehörige

ConnectionIndex

Ein Wert, der größer oder gleich 1 ist, der die Anzahl des Ports angibt.

DeviceDescriptor

Eine USB_DEVICE_DESCRIPTOR Struktur, die den USB-Gerätedeskriptor meldet, der während der Enumeration vom angeschlossenen Gerät zurückgegeben wird.

CurrentConfigurationValue

Enthält die ID, die mit der SetConfiguration-Anforderung verwendet wird, um anzugeben, dass die aktuelle Konfiguration des Geräts, das mit dem angegebenen Port verbunden ist. Eine Erläuterung dieses Werts finden Sie in Abschnitt 9.4.7 in der Spezifikation universal Serial Bus 3.1, die unter USB-Dokumentbibliothekverfügbar ist.

LowSpeed

Ein boolescher Wert, der angibt, ob der Port und das verbundene Gerät mit niedriger Geschwindigkeit ausgeführt werden. TRUE gibt an, dass der Port und das angeschlossene Gerät derzeit mit einer niedrigen Geschwindigkeit arbeiten. FALSE- weist andernfalls darauf hin.

DeviceIsHub

Ein boolescher Wert, der angibt, ob das an den Port angeschlossene Gerät ein Hub ist. Wenn TRUE-, ist das gerät, das an den Port angeschlossen ist, ein Hub. Wenn FALSE, ist das Gerät kein Hub.

DeviceAddress

Die usb zugewiesene, busrelative Adresse des Geräts, das an den Anschluss angeschlossen ist.

NumberOfOpenPipes

Die Anzahl der offenen USB-Rohre, die dem Anschluss zugeordnet sind.

ConnectionStatus

Ein USB_CONNECTION_STATUS-typed-Enumerator, der den Verbindungsstatus angibt.

PipeList[0]

Ein Array von USB_PIPE_INFO Strukturen, die die offenen Rohre beschreiben, die dem Port zugeordnet sind. Pipebeschreibungen umfassen den Zeitplanoffset der Pipe und den zugehörigen Endpunktdeskriptor. Diese Informationen können verwendet werden, um die Bandbreitennutzung zu berechnen.

Bemerkungen

Wenn kein Gerät mit dem USB-Anschluss verbunden ist, gibt IOCTL_USB_GET_NODE_CONNECTION_INFORMATION nur Informationen zum Anschluss zurück. Wenn ein Gerät mit dem Port verbunden ist, gibt IOCTL_USB_GET_NODE_CONNECTION_INFORMATION Informationen über den Port und das verbundene Gerät zurück.

Die USB_NODE_CONNECTION_INFORMATION_EX-Struktur ist eine erweiterte Version von USB_NODE_CONNECTION_INFORMATION. Die beiden Strukturen sind identisch, mit Ausnahme eines Mitglieds. In USB_NODE_CONNECTION_INFORMATION_EXwird das LowSpeed Mitglied durch das mitglied Speed ersetzt. LowSpeed ein boolescher Wert ist. Wenn es also TRUE-ist, ist das Gerät mit niedriger Geschwindigkeit. Wenn es FALSE-ist, ist das Gerät hochgeschwindigkeits oder voll. Daher kann die USB_NODE_CONNECTION_INFORMATION Struktur nicht zwischen hohen und vollen Geschwindigkeiten unterscheiden.

Das Speed Member der USB_NODE_CONNECTION_INFORMATION_EX-Struktur ist ein UCHAR-Element und kann alle Werte des USB_DEVICE_SPEED Enumerators angeben.