UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS-Struktur (ucxcontroller.h)

  • Artikel

Speichert die Transporteigenschaften zu relevanten Zeitpunkten. Diese Struktur wird in der rückruffunktion EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS verwendet.

Syntax

typedef struct _UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS {
  ULONG   TransportCharacteristicsFlags;
  ULONG64 CurrentRoundtripLatencyInMilliSeconds;
  ULONG64 MaxPotentialBandwidth;
} UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS, *PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS;

Member

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 ucxcontroller.h (ucxclass.h einschließen)

Weitere Informationen

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS