UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS struttura (ucxcontroller.h)

  • Articolo

Archivia le caratteristiche del trasporto in momenti rilevanti. 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;

Members

TransportCharacteristicsFlags

Maschera di bit che indica al driver client le caratteristiche di trasporto disponibili e vengono 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 corrente del round trip in millisecondi dal momento in cui un trasferimento non isochronoo viene ricevuto dallo stack di driver USB al momento del completamento del trasferimento.

Per MA-USB, la rete sottostante potrebbe essere WiFi, 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 viene notificata 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 WiFi, 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 una query sulla larghezza di banda totale periodicamente o ogni volta che viene notificata una modifica.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1709
Server minimo supportato Windows Server 2016
Intestazione ucxcontroller.h (includere Ucxclass.h)

Vedi anche

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS