Condividi tramite


struttura USB_TRANSPORT_CHARACTERISTICS (usbioctl.h)

Archivia le caratteristiche di trasporto in momenti pertinenti. Questa struttura viene utilizzata 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;

Membri

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

Vedere anche

IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS