Share via


UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS structure (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 entre le moment où un transfert non isochronique est reçu par la pile de pilotes USB et le 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 la latence régulièrement 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 totale disponible peut varier en fonction de plusieurs facteurs tels que le canal Wi-Fi de négociation. Un pilote client doit interroger la bande passante totale régulièrement ou chaque fois qu’il est averti d’une modification.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709
Serveur minimal pris en charge Windows Server 2016
En-tête ucxcontroller.h (inclure Ucxclass.h)

Voir aussi

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS