UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS-Struktur (ucxcontroller.h)
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) |