Partager via


structure UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS (ucxcontroller.h)

Stocke les caractéristiques de transport à des moments pertinents. Cette structure est utilisée dans la fonction de rappel EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS.

Syntaxe

typedef struct _UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS {
  ULONG   TransportCharacteristicsFlags;
  ULONG64 CurrentRoundtripLatencyInMilliSeconds;
  ULONG64 MaxPotentialBandwidth;
} UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS, *PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS;

Membres

TransportCharacteristicsFlags

Masque de bits qui indique au pilote client les caractéristiques de transport disponibles et retournées dans cette structure.

Si USB_TRANSPORT_CHARACTERISTICS_LATENCY_AVAILABLE

est défini, CurrentRoundtripLatencyInMilliSeconds contient des informations valides. Sinon, il ne doit pas être utilisé par le pilote client.

Si USB_TRANSPORT_CHARACTERISTICS_BANDWIDTH_AVAILABLE

est défini, MaxPotentialBandwidth contient des informations valides. Sinon, il ne doit pas être utilisé par le pilote client.

CurrentRoundtripLatencyInMilliSeconds

Contient le délai d’aller-retour actuel en millisecondes du moment où un transfert non isochronique est reçu par la pile des pilotes USB jusqu’au moment où le transfert est terminé.

Pour MA-USB, le réseau sous-jacent peut être WiFi, WiGig, Ethernet, etc. Le délai peut varier en fonction des conditions réseau sous-jacentes. Un pilote client doit interroger périodiquement la latence ou chaque fois qu’il est averti d’une modification.

MaxPotentialBandwidth

Contient la bande passante totale du transport partagé du contrôleur hôte.

Pour MA-USB, le transport réseau sous-jacent peut être WiFi, WiGig, Ethernet, etc. La bande passante disponible totale peut varier en fonction de plusieurs facteurs tels que le canal WiFi de négociation. Un pilote client doit interroger régulièrement la bande passante totale ou chaque fois qu’il est averti d’une modification.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1709
serveur minimum pris en charge Windows Server 2016
d’en-tête ucxcontroller.h (include Ucxclass.h)

Voir aussi

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS