Événements d’arrêt TraceLogging USB4™
Les pilotes du routeur hôte USB4 et du routeur de périphérique émettent des événements TraceLogging pour signaler l’état du domaine. Ces événements sont appelés événements d’arrêt et sont signalés par les pilotes lorsqu’une session de trace ETW pour les fournisseurs de traces suivants est activée. Ces événements décrivent le domaine par le biais d’une série d’événements. Une fois les événements d’arrêt émis, les pilotes USB4 continueront à signaler les événements lors de l’énumération et de la suppression du routeur.
Nom du fournisseur ETW : « Microsoft.Windows.USB.USB4.HostRouter » GUID du fournisseur ETW : {575BA31F-2B45-58C2-64FD-F5DC757B6137}
Nom du fournisseur ETW : « Microsoft.Windows.USB.USB4.DeviceRouter » GUID du fournisseur ETW : {AE795D36-2B11-5EFB-C7E0-5D552BC55D6C}
Les tableaux suivants décrivent certains événements TraceLogging intéressants.
Event RundownStart et RundownComplete sont des événements de marqueur permettant de désigner le début et la fin des événements d’arrêt. Ils n’emportent aucune propriété d’événement ou charge utile avec eux.
Event DeviceRouterInformation
Propriété Type de valeur Description IsRundownEvent Booléen True s’il s’agit d’un événement d’arrêt. False s’il signale un nouveau routeur d’appareil. DomainID HexUInt32 ID de domaine de ce routeur d’appareil. TopologyID UInt8FixedArray(7) ID de topologie de 7 octets de ce routeur d’appareil. DeviceInstancePath WideString Le chemin d’accès de l’appareil pnP affecté instance du routeur de l’appareil.
Il peut être utilisé pour faire correspondre les données de propriété DEVPKEY_Device_InstanceId retournées par les API PnP dans le modèle de propriété d’appareil unifié.VendorId HexUInt16 ID de fournisseur ProductId HexUInt16 Product ID AsciiVendorName String Nom du fournisseur en ASCII. Il est défini dans le chapitre Entrée du nom du fournisseur ASCII de la spécification DROM USB4. AsciiModelName String Nom du modèle en ASCII. Il est défini dans le chapitre Entrée de nom de modèle ASCII de la spécification DROM USB4. DeviceID HexUInt16 Pour Thunderbolt™ 3, il s’agit du champ « VendorId » dans la section d’en-têtes Thunderbolt™ 3.
Pour USB4, il s’agit du champ « idVendor » dans l’entrée de descripteur de produit.ModelID HexUInt16 Pour Thunderbolt™ 3, il s’agit du champ « ID du modèle » dans la section d’en-têtes Thunderbolt™ 3.
Pour USB4, il s’agit du champ « idProduct » dans l’entrée de descripteur de produit.UUID HexUInt64 UUID de l’appareil. Pour USB4, il s’agit de l’UUID dans les registres ROUTER_CS_7 et ROUTER_CS_8 définis par la spécification USB4. DeviceFirmwareVersion HexUInt32 Version du microprogramme de l’appareil. Event PortInformation
Propriété Type de valeur Description IsRundownEvent Booléen True s’il s’agit d’un événement d’arrêt. False s’il signale un nouveau routeur d’appareil. IsNewDeviceRouter Booléen True s’il signale un port d’un nouveau routeur d’appareil. False s’il signale un changement de port status. Pour les événements d’exécution, elle est également false. DomainID HexUInt32 ID de domaine de ce routeur d’appareil. TopologyID UInt8FixedArray(7) ID de topologie de 7 octets de ce routeur d’appareil. IsDFP Booléen True si le port associé est DFP. False s’il s’agit de UFP. Lane0AdapterNumber UInt8 Le « Numéro d’adaptateur » du registre de l’espace de configuration de l’adaptateur ADP_CS_3. Lane1AdapterNumber UInt8 Le « Numéro d’adaptateur » du registre de l’espace de configuration de l’adaptateur ADP_CS_3. DownstreamRouterDomainID HexUInt32 ID de domaine du routeur d’appareil en aval. DownstreamRouterTopologyID UInt8FixedArray(7) ID de topologie de 7 octets du routeur d’appareil en aval. Tous les zéros si aucun routeur d’appareil n’est connecté en aval. SupportedLinkSpeeds HexUInt8 La valeur de la fonctionnalité de configuration de l’adaptateur de voie inscrit LANE_ADP_CS_0[19..16] « Vitesses de liaison prises en charge ». SupportedLinkWidths HexUInt8 La valeur de la fonctionnalité de configuration de l’adaptateur de voie inscrit LANE_ADP_CS_0[25..20] « Largeurs de liaison prises en charge ». CurrentLinkSpeed HexUInt8 La valeur de la fonctionnalité de configuration de l’adaptateur de voie inscrit LANE_ADP_CS_1[19..16] « Vitesse de liaison actuelle ». NegotiatedLinkWidth HexUInt8 La valeur de la fonctionnalité de configuration de l’adaptateur de voie inscrit LANE_ADP_CS_1[25..20] « Largeur de liaison négociée ». TargetLinkSpeed HexUInt8 La valeur de la fonctionnalité de configuration de l’adaptateur de voie inscrit LANE_ADP_CS_1[3..0] « Vitesse de liaison cible ». TargetLinkWidth HexUInt8 La valeur de la fonctionnalité de configuration de l’adaptateur de voie inscrit LANE_ADP_CS_1[9..4] « Largeur du lien cible ». AdapterState HexUInt8 La valeur de la fonctionnalité de configuration de l’adaptateur de voie inscrit LANE_ADP_CS_1[29..26] « État de l’adaptateur ». LaneBonded Booléen Indique si les voies de ce port sont collées. CableUsbVersion Booléen La valeur de la fonctionnalité de port inscrit PORT_CS_18[7..0] « Version USB du câble ». LinkCLxSupport Booléen Valeur du registre des capacités de port PORT_CS_18[10] « Link CLx Support (LCL) ». Tbt3CompatibleMode Booléen La valeur du registre des capacités de port PORT_CS_18[9] « Mode compatible TBT3 (TCM) ». Événement PCIeAdapterInformation
Propriété Type de valeur Description IsRundownEvent Booléen True s’il s’agit d’un événement d’exécution. False s’il signale un nouveau routeur d’appareil. IsNewDeviceRouter Booléen True s’il signale un port d’un nouveau routeur d’appareil. False s’il signale un port status modification. Pour les événements d’exécution, elle est également false. DomainID HexUInt32 ID de domaine de ce routeur d’appareil. TopologyID UInt8FixedArray(7) ID de topologie de 7 octets de ce routeur d’appareil. AdapterNumber Uint8 Le « Numéro d’adaptateur » du registre d’espace de configuration de l’adaptateur ADP_CS_3. AdapterType HexUInt32 Registre d’espace de configuration de l’adaptateur ADP_CS_2[23..0]. Il combine les valeurs de « Adapter Type Protocol », « Adapter Type Version » et « Adapter Type Sub-Type ».
Informations de référence sur les spécifications : « Tableau 8-9. Attributs de base de l’espace de configuration de l’adaptateur » et « Tableau 8-10. Types d’adaptateurs »IsDownstream Booléen True s’il s’agit d’un adaptateur PCIe en aval. False si elle est amont. IsTunneled Booléen True si le trafic de protocole est tunnelisé. Événement DPAdapterInformation
Propriété Type de valeur Description IsRundownEvent Booléen True s’il s’agit d’un événement d’exécution. False s’il signale un nouveau routeur d’appareil. IsNewDeviceRouter Booléen True s’il signale un port d’un nouveau routeur d’appareil. False s’il signale un port status modification. Pour les événements d’exécution, elle est également false. DomainID HexUInt32 ID de domaine de ce routeur d’appareil. TopologyID Uint8FixedArray(7) ID de topologie de 7 octets de ce routeur d’appareil. AdapterNumber Uint8 Le « Numéro d’adaptateur » du registre d’espace de configuration de l’adaptateur ADP_CS_3. AdapterType HexUInt32 Registre d’espace de configuration de l’adaptateur ADP_CS_2[23..0]. Il combine les valeurs de « Adapter Type Protocol », « Adapter Type Version » et « Adapter Type Sub-Type ».
Informations de référence sur les spécifications : « Tableau 8-9. Attributs de base de l’espace de configuration de l’adaptateur » et « Tableau 8-10. Types d’adaptateurs »IsDPOut Booléen True s’il s’agit d’un adaptateur DP Out. False s’il s’agit de DP In. IsTunneled Booléen True si le trafic de protocole est tunnelisé. MaximumLinkRate HexUInt8 La valeur du registre d’espace de configuration de l’adaptateur DP DP_COMMON_CAP[11..8] « Taux de liaison maximal ». MaximumLinkCount HexUInt8 La valeur du registre d’espace de configuration de l’adaptateur DP DP_COMMON_CAP[14..12] « Nombre maximal de liens ». Événement USB3AdapterInformation
Propriété Type de valeur Description IsRundownEvent Booléen True s’il s’agit d’un événement d’exécution. False s’il signale un nouveau routeur d’appareil. IsNewDeviceRouter Booléen True s’il signale un port d’un nouveau routeur d’appareil. False s’il signale un port status modification. Pour les événements d’exécution, elle est également false. DomainID HexUInt32 ID de domaine de ce routeur d’appareil. TopologyID UInt8FixedArray(7) ID de topologie de 7 octets de ce routeur d’appareil. AdapterNumber UInt8 Le « Numéro d’adaptateur » du registre d’espace de configuration de l’adaptateur ADP_CS_3. AdapterType HexUInt32 Registre d’espace de configuration de l’adaptateur ADP_CS_2[23..0]. Il combine les valeurs de « Adapter Type Protocol », « Adapter Type Version » et « Adapter Type Sub-Type ».
Informations de référence sur les spécifications : « Tableau 8-9. Attributs de base de l’espace de configuration de l’adaptateur » et « Tableau 8-10. Types d’adaptateurs »IsDownstream Booléen True s’il s’agit d’un adaptateur USB 3.x en aval. False si elle est amont. IsTunneled Booléen True si le trafic de protocole est tunnelisé. ActualLinkRate HexUInt8 La valeur de l’espace de configuration de l’adaptateur USB 3.x ADP_USB3_CS_4[6..0] « Taux de liaison réel ». Event OtherAdapterInformation
Propriété Type de valeur Description IsRundownEvent Booléen True s’il s’agit d’un événement d’exécution. False s’il signale un nouveau routeur d’appareil. IsNewDeviceRouter Booléen True s’il signale un port d’un nouveau routeur d’appareil. False s’il signale un port status modification. Pour les événements d’exécution, elle est également false. DomainID HexUInt32 ID de domaine de ce routeur d’appareil. TopologyID UInt8FixedArray(7) ID de topologie de 7 octets de ce routeur d’appareil. AdapterNumber UInt8 Le « Numéro d’adaptateur » du registre d’espace de configuration de l’adaptateur ADP_CS_3. AdapterType HexUInt32 Registre d’espace de configuration de l’adaptateur ADP_CS_2[23..0]. Il combine les valeurs de « Adapter Type Protocol », « Adapter Type Version » et « Adapter Type Sub-Type ».
Informations de référence sur les spécifications : « Tableau 8-9. Attributs de base de l’espace de configuration de l’adaptateur » et « Tableau 8-10. Types d’adaptateurs »Event InterDomainPeerInformation
Propriété Type de valeur Description IsRundownEvent Booléen True s’il s’agit d’un événement d’exécution. DomainID HexUInt32 ID de domaine de ce routeur d’appareil. TopologyID UInt8FixedArray(7) ID de topologie de 7 octets de ce routeur d’appareil. Lane0AdapterNumber UInt8 Numéro d’adaptateur de voie 0 du port local. Identique à Lane0AdapterNumber de l’événement
« PortInformation ».Il peut être utilisé avec les propriétés « DomainID » et « TopologyID » ci-dessus pour rechercher l’événement « PortInformation » correspondant.LocalDomainUUID GUID UUID de domaine du domaine local dans une connexion inter-domaines. RemoteDomainUUID GUID UUID de domaine du domaine distant dans une connexion inter-domaines. LocalRouteString UInt8FixedArray(7) Chaîne de routage pour le port local. Il est au format d’ID de topologie 7-UINT8. RemoteRouteString UInt8FixedArray(7) Chaîne de routage pour le port distant. Il est au format d’ID de topologie 7-UINT8 MaxHopID UInt16 Propriété « MaxHopID » du bloc de propriétés inter-domaines retourné par l’homologue distant. Événement DeviceRouterRemoval
Propriété Type de valeur Description DomainID HexUInt32 ID de domaine du routeur d’appareil. TopologyID UInt8FixedArray(7) ID de topologie de 7 octets du routeur de l’appareil.
Thunderbolt est une marque commerciale d’Intel Corporation ou de ses filiales.