USB_TRANSPORT_CHARACTERISTICS struttura (usbioctl.h)

  • Articolo

Archivia le caratteristiche del trasporto in momenti rilevanti. Questa struttura viene usata nella richiesta di IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS .

Sintassi

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

Members

Version

La versione è impostata su USB_TRANSPORT_CHARACTERISTICS_VERSION_1.

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 usbioctl.h

Vedi anche

IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS