USB_NODE_CONNECTION_INFORMATION_EX-Struktur (usbioctl.h)

  • Artikel

Die USB_NODE_CONNECTION_INFORMATION_EX-Struktur wird in Verbindung mit der IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX-Anforderung verwendet, um Informationen über die Verbindung zu erhalten, die dem angegebenen USB-Anschluss zugeordnet ist.

Syntax

typedef struct _USB_NODE_CONNECTION_INFORMATION_EX {
  ULONG                 ConnectionIndex;
  USB_DEVICE_DESCRIPTOR DeviceDescriptor;
  UCHAR                 CurrentConfigurationValue;
  UCHAR                 Speed;
  BOOLEAN               DeviceIsHub;
  USHORT                DeviceAddress;
  ULONG                 NumberOfOpenPipes;
  USB_CONNECTION_STATUS ConnectionStatus;
  USB_PIPE_INFO         PipeList[0];
} USB_NODE_CONNECTION_INFORMATION_EX, *PUSB_NODE_CONNECTION_INFORMATION_EX;

Member

ConnectionIndex

Enthält einen Wert größer oder gleich 1, der die Nummer des Ports angibt.

DeviceDescriptor

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

CurrentConfigurationValue

Enthält die ID, die mit der SetConfiguration-Anforderung verwendet wird, um die aktuelle Konfiguration des Geräts anzugeben, das mit dem angegebenen Port verbunden ist. Eine Erläuterung dieses Werts finden Sie im Abschnitt 9.4.7 in der Spezifikation für den universellen seriellen Bus 3.1, die in der USB-Dokumentbibliothek verfügbar ist.

Speed

Enthält einen Wert vom Typ USB_DEVICE_SPEED , der die Geschwindigkeit des Geräts angibt.

DeviceIsHub

Gibt bei TRUE an, dass das an den Port angefügte Gerät ein Hub ist.

DeviceAddress

Enthält die über USB zugewiesene, busrelative Adresse des Geräts, das an den Port angeschlossen ist.

NumberOfOpenPipes

Gibt die Anzahl der geöffneten USB-Leitungen an, die dem Port zugeordnet sind.

ConnectionStatus

Enthält einen Enumerator vom Typ USB_CONNECTION_STATUS, der die Verbindung status angibt.

PipeList[0]

Enthält ein Array von Strukturen vom Typ USB_PIPE_INFO , das die offenen Pipes beschreibt, 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.

Hinweise

Wenn kein Gerät verbunden ist, gibt IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX nur Informationen über den Port zurück. Wenn ein Gerät mit dem Port verbunden ist , IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX Informationen sowohl über den Port als auch über das verbundene Gerät zurückgibt.

Die USB_NODE_CONNECTION_INFORMATION_EX-Struktur ist eine erweiterte Version von USB_NODE_CONNECTION_INFORMATION. Die beiden Strukturen sind identisch, mit Ausnahme eines Elements. In der erweiterten Struktur gibt der Speed-Member die Gerätegeschwindigkeit an.

Der Speed-Member der USB_NODE_CONNECTION_INFORMATION_EX-Struktur ist eine UCHAR und kann jeden der Werte des USB_DEVICE_SPEED-Enumerators angeben. Der Speed-Member unterstützt bis zu UsbHighSpeed (USB 2.0). Um festzustellen, ob ein Gerät UsbSuperSpeed (USB 3.0) unterstützt, verwenden Sie die USB_NODE_CONNECTION_INFORMATION_EX_V2-Struktur .

Der folgende C++-Codeausschnitt aus dem USBView-Beispiel veranschaulicht, wie Sie ermitteln, ob ein Gerät UsbSuperSpeed (USB 3.0) unterstützt:

// Since the USB_NODE_CONNECTION_INFORMATION_EX is used to display
// the device speed, but the hub driver doesn't support indication
// of superspeed, we overwrite the value if the super speed
// data structures are available and indicate the device is operating
// at SuperSpeed.

if (connectionInfoEx->Speed == UsbHighSpeed 
    && connectionInfoExV2 != NULL 
    && (connectionInfoExV2->Flags.DeviceIsOperatingAtSuperSpeedOrHigher ||
        connectionInfoExV2->Flags.DeviceIsOperatingAtSuperSpeedPlusOrHigher))
{
    connectionInfoEx->Speed = UsbSuperSpeed;
}

Anforderungen

Anforderung Wert
Header usbioctl.h (include Usbioctl.h)

Weitere Informationen