struttura UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS (ucxcontroller.h)
Archivia le caratteristiche di trasporto in momenti pertinenti. Questa struttura viene usata nella funzione di callback EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS.
Sintassi
typedef struct _UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS {
ULONG TransportCharacteristicsFlags;
ULONG64 CurrentRoundtripLatencyInMilliSeconds;
ULONG64 MaxPotentialBandwidth;
} UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS, *PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS;
Membri
TransportCharacteristicsFlags
Maschera di bit che indica al driver client le caratteristiche di trasporto disponibili e restituite in questa struttura.
Se USB_TRANSPORT_CHARACTERISTICS_LATENCY_AVAILABLE
è impostato, CurrentRoundtripLatencyInMilliSeconds contiene informazioni valide. In caso contrario, non deve essere usato dal driver client.
Se USB_TRANSPORT_CHARACTERISTICS_BANDWIDTH_AVAILABLE
è impostato, MaxPotentialBandwidth contiene informazioni valide. In caso contrario, non deve essere usato dal driver client.
CurrentRoundtripLatencyInMilliSeconds
Contiene il ritardo di round trip corrente in millisecondi dal momento in cui un trasferimento non isocrono viene ricevuto dallo stack di driver USB al momento in cui il trasferimento viene completato.
Per MA-USB, la rete sottostante potrebbe essere Wi-Fi, WiGig, Ethernet e così via. Il ritardo può variare a seconda delle condizioni di rete sottostanti. Un driver client deve eseguire una query sulla latenza periodicamente o ogni volta che riceve una notifica di una modifica.
MaxPotentialBandwidth
Contiene la larghezza di banda totale del trasporto condiviso del controller host.
Per MA-USB, il trasporto di rete sottostante potrebbe essere Wi-Fi, WiGig, Ethernet e così via. La larghezza di banda totale disponibile può variare a seconda di diversi fattori, ad esempio il canale WiFi di negoziazione. Un driver client deve eseguire periodicamente una query sulla larghezza di banda totale o ogni volta che riceve una notifica di una modifica.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10, versione 1709 |
| server minimo supportato | Windows Server 2016 |
| intestazione | ucxcontroller.h (include Ucxclass.h) |