USB_TRANSPORT_CHARACTERISTICS Struktur (usbioctl.h)

  • Artikel

Speichert die Transporteigenschaften zu relevanten Zeitpunkten. Diese Struktur wird in der IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS-Anforderung verwendet.

Syntax

typedef struct _USB_TRANSPORT_CHARACTERISTICS {
  ULONG   Version;
  ULONG   TransportCharacteristicsFlags;
  ULONG64 CurrentRoundtripLatencyInMilliSeconds;
  ULONG64 MaxPotentialBandwidth;
} USB_TRANSPORT_CHARACTERISTICS, *PUSB_TRANSPORT_CHARACTERISTICS;

Member

Version

Die Version ist auf USB_TRANSPORT_CHARACTERISTICS_VERSION_1 festgelegt.

TransportCharacteristicsFlags

Eine Bitmaske, die dem Clienttreiber die Transportmerkmale angibt, die verfügbar sind und in dieser Struktur zurückgegeben werden.

Wenn USB_TRANSPORT_CHARACTERISTICS_LATENCY_AVAILABLE

ist festgelegt, CurrentRoundtripLatencyInMilliSeconds enthält gültige Informationen. Andernfalls darf er nicht vom Clienttreiber verwendet werden.

Wenn USB_TRANSPORT_CHARACTERISTICS_BANDWIDTH_AVAILABLE

ist festgelegt, MaxPotentialBandwidth enthält gültige Informationen. Andernfalls darf er nicht vom Clienttreiber verwendet werden.

CurrentRoundtripLatencyInMilliSeconds

Enthält die aktuelle Roundtripverzögerung in Millisekunden zwischen dem Empfang einer nicht isochronen Übertragung durch den USB-Treiberstapel und dem Zeitpunkt, zu dem die Übertragung abgeschlossen ist.

Für MA-USB könnte das zugrunde liegende Netzwerk WLAN, WiGig, Ethernet usw. sein. Die Verzögerung kann je nach zugrunde liegenden Netzwerkbedingungen variieren. Ein Clienttreiber sollte die Latenz in regelmäßigen Abständen oder bei jeder Benachrichtigung über eine Änderung abfragen.

MaxPotentialBandwidth

Enthält die Gesamtbandbreite des freigegebenen Transports des Hostcontrollers.

Für MA-USB kann der zugrunde liegende Netzwerktransport WLAN, WiGig, Ethernet usw. sein. Die gesamte verfügbare Bandbreite kann abhängig von mehreren Faktoren wie dem WLAN-Verhandlungskanal variieren. Ein Clienttreiber sollte die Gesamtbandbreite in regelmäßigen Abständen oder bei jeder Benachrichtigung über eine Änderung abfragen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1709
Unterstützte Mindestversion (Server) Windows Server 2016
Kopfzeile usbioctl.h

Weitere Informationen

IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS