Condividi tramite

Eventi di rundown USB4™ di TraceLogging

  • Articolo

I driver del router host USB4 e del router del dispositivo generano eventi TraceLogging per segnalare lo stato del dominio. Questi eventi sono noti come eventi di rundown e vengono segnalati dai driver quando è abilitata una sessione di traccia ETW per i provider di traccia seguenti. Questi eventi descrivono il dominio tramite una serie di eventi. Dopo aver generato gli eventi di rundown, i driver USB4 continueranno a segnalare eventi sull'enumerazione del router e sulla rimozione.

Nome del provider ETW: "Microsoft.Windows.USB.USB4.HostRouter" GUID del provider ETW: {575BA31F-2B45-58C2-64FD-F5DC757B6137}

Nome del provider ETW: "Microsoft.Windows.USB.USB4.DeviceRouter" GUID del provider ETW: {AE795D36-2B11-5EFB-C7E0-5D552BC555D6C}

Le tabelle seguenti descrivono alcuni eventi TraceLogging di interesse.

  1. RundownStart e RundownComplete sono eventi di indicatore per indicare l'inizio e la fine degli eventi di rundown. Non trasportano proprietà di eventi o payload con loro.

  2. DeviceRouterInformation evento

    Proprietà Tipo di valore Descrizione
    IsRundownEvent Boolean True se si tratta di un evento di rundown. False se segnala un nuovo router del dispositivo.
    DomainID HexUInt32 ID di dominio di questo router del dispositivo.
    TopologyID UInt8FixedArray(7) ID topologia a 7 byte del router del dispositivo.
    DeviceInstancePath WideString Percorso dell'istanza del dispositivo assegnata da PnP del router del dispositivo.

    Può essere usato per corrispondere ai dati delle proprietà DEVPKEY_Device_InstanceId restituiti dalle API PnP nel modello di proprietà dispositivo unificato .
    VendorId HexUInt16 ID fornitore
    ProductId HexUInt16 Product ID
    AsciiVendorName string Nome del fornitore in ASCII. Viene definito nel capitolo ASCII Vendor Name Entry della specifica USB4 DROM.
    AsciiModelName string Nome del modello in ASCII. Viene definito nel capitolo ASCII Model Name Entry della specifica USB4 DROM.
    Deviceid HexUInt16 Per Thunderbolt 3, è il campo "VendorId" nella™ sezione intestazione Thunderbolt™ 3.
    Per USB4, è il campo "idVendor" nella voce del descrittore prodotto.
    ModelID HexUInt16 Per Thunderbolt 3, è il campo "ID modello" nella™ sezione intestazione Thunderbolt™ 3.
    Per USB4, è il campo "idProduct" nella voce del descrittore prodotto.
    UUID HexUInt64 UUID del dispositivo. Per USB4, è l'UUID nella ROUTER_CS_7 e i registri ROUTER_CS_8 definiti dalla specifica USB4.
    DeviceFirmwareVersion HexUInt32 Versione del firmware del dispositivo.

  3. Porta eventoInformation

    Proprietà Tipo di valore Descrizione
    IsRundownEvent Boolean True se si tratta di un evento di rundown. False se segnala un nuovo router del dispositivo.
    IsNewDeviceRouter Boolean True se segnala una porta di un nuovo router del dispositivo. False se segnala una modifica dello stato della porta. Per gli eventi di rundown, è anche false.
    DomainID HexUInt32 ID di dominio di questo router del dispositivo.
    TopologyID UInt8FixedArray(7) ID topologia a 7 byte del router del dispositivo.
    IsDFP Boolean True se la porta associata è DFP. False se è UFP.
    Lane0AdapterNumber UInt8 Registro dello spazio di configurazione della scheda "Adapter Number" ADP_CS_3.
    Lane1AdapterNumber UInt8 Registro dello spazio di configurazione della scheda "Adapter Number" ADP_CS_3.
    DownstreamRouterDomainID HexUInt32 ID di dominio del router del dispositivo downstream.
    DownstreamRouterTopologyID UInt8FixedArray(7) ID topologia a 7 byte del router del dispositivo downstream. Tutti gli zero se nessun router del dispositivo è connesso downstream.
    SupportLinkSpeeds HexUInt8 Il valore della funzionalità di configurazione della scheda lane registra LANE_ADP_CS_0[19..16] "Velocità di collegamento supportate".
    SupportLinkWidths HexUInt8 Il valore della funzionalità di configurazione della scheda lane registra LANE_ADP_CS_0[25..20] "Larghezza collegamento supportata".
    CurrentLinkSpeed HexUInt8 Il valore della funzionalità di configurazione dell'adattatore lane registra LANE_ADP_CS_1[19..16] "Current Link Speed".
    NegotiatedLinkWidth HexUInt8 Il valore della funzionalità di configurazione dell'adattatore lane registra LANE_ADP_CS_1[25..20] "Negotiated Link Width".
    TargetLinkSpeed HexUInt8 Il valore della funzionalità di configurazione dell'adattatore lane registra LANE_ADP_CS_1[3..0] "Velocità collegamento di destinazione".
    TargetLinkWidth HexUInt8 Il valore della funzionalità di configurazione dell'adattatore lane registra LANE_ADP_CS_1[9..4] "Larghezza collegamento di destinazione".
    AdapterState HexUInt8 Il valore della funzionalità di configurazione dell'adattatore lane registra LANE_ADP_CS_1[29..26] "Stato adattatore".
    LaneBonded Boolean Indica se le corsie di questo porto sono collegate.
    CableUsbVersion Boolean Il valore della funzionalità di porta registra PORT_CS_18[7..0] "Versione USB cavo".
    LinkCLxSupport Boolean Il valore della funzionalità di porta registra PORT_CS_18[10] "Link CLx Support (LCL)".
    Tbt3CompatibleMode Boolean Il valore della funzionalità di porta registra PORT_CS_18[9] "TbT3-Compatible Mode (TCM)".

  4. PCIeAdapterInformation dell'evento

    Proprietà Tipo di valore Descrizione
    IsRundownEvent Boolean True se si tratta di un evento rundown. False se segnala un nuovo router del dispositivo.
    IsNewDeviceRouter Boolean True se segnala una porta di un nuovo router del dispositivo. False se segnala una modifica dello stato della porta. Per gli eventi di rundown, è anche false.
    DomainID HexUInt32 ID di dominio del router del dispositivo.
    TopologyID UInt8FixedArray(7) ID topologia a 7 byte del router del dispositivo.
    AdapterNumber Uint8 Registro dello spazio di configurazione dell'adattatore "Numero adattatore" ADP_CS_3.
    AdapterType HexUInt32 Registrare lo spazio di configurazione dell'adattatore ADP_CS_2[23..0]. Combina i valori di "Adapter Type Protocol", "Adapter Type Version" e "Adapter Type Sub-Type".

    Riferimento alle specifiche: "Tabella 8-9. Attributi di base dello spazio di configurazione dell'adattatore e "Tabella 8-10. Tipi di adattatori"
    IsDownstream Boolean True se si tratta di un adattatore PCIe downstream. False se è a monte.
    IsTunneled Boolean True se il traffico del protocollo viene sottoposto a tunneling.

  5. Evento DPAdapterInformation

    Proprietà Tipo di valore Descrizione
    IsRundownEvent Boolean True se si tratta di un evento rundown. False se segnala un nuovo router del dispositivo.
    IsNewDeviceRouter Boolean True se segnala una porta di un nuovo router del dispositivo. False se segnala una modifica dello stato della porta. Per gli eventi di rundown, è anche false.
    DomainID HexUInt32 ID di dominio del router del dispositivo.
    TopologyID Uint8FixedArray(7) ID topologia a 7 byte del router del dispositivo.
    AdapterNumber Uint8 Registro dello spazio di configurazione dell'adattatore "Numero adattatore" ADP_CS_3.
    AdapterType HexUInt32 Registrare lo spazio di configurazione dell'adattatore ADP_CS_2[23..0]. Combina i valori di "Adapter Type Protocol", "Adapter Type Version" e "Adapter Type Sub-Type".

    Riferimento alle specifiche: "Tabella 8-9. Attributi di base dello spazio di configurazione dell'adattatore e "Tabella 8-10. Tipi di adattatori"
    IsDPOut Boolean True se si tratta di un adattatore DP Out. False se è DP In.
    IsTunneled Boolean True se il traffico del protocollo viene sottoposto a tunneling.
    MaximalLinkRate HexUInt8 Il valore dello spazio di configurazione dell'adattatore DP registra DP_COMMON_CAP[11..8] "Maximal Link Rate".
    MaximalLinkCount HexUInt8 Il valore dello spazio di configurazione della scheda DP registra DP_COMMON_CAP[14..12] "Maximal Link Count".

  6. Evento USB3AdapterInformation

    Proprietà Tipo di valore Descrizione
    IsRundownEvent Boolean True se si tratta di un evento di rundown. False se segnala un nuovo router del dispositivo.
    IsNewDeviceRouter Boolean True se segnala una porta di un nuovo router del dispositivo. False se segnala una modifica dello stato della porta. Per gli eventi di rundown, è anche false.
    DomainID HexUInt32 ID di dominio di questo router del dispositivo.
    TopologyID UInt8FixedArray(7) ID topologia a 7 byte del router del dispositivo.
    AdapterNumber UInt8 Registro dello spazio di configurazione della scheda "Adapter Number" ADP_CS_3.
    AdapterType HexUInt32 Registrare lo spazio di configurazione dell'adattatore ADP_CS_2[23..0]. Combina i valori di "Adapter Type Protocol", "Adapter Type Version" e "Adapter Type Sub-Type".

    Riferimento specifico: "Tabella 8-9. Attributi di base dello spazio di configurazione della scheda e "Tabella 8-10. Tipi di adattatore"
    IsDownstream Boolean True se è un adattatore USB 3.x downstream. False se è upstream.
    IsTunneled Boolean True se il traffico del protocollo viene sottoposto a tunneling.
    ActualLinkRate HexUInt8 Il valore dello spazio di configurazione dell'adattatore USB 3.x ADP_USB3_CS_4[6..0] "Velocità collegamento effettiva".

  7. Evento OtherAdapterInformation

    Proprietà Tipo di valore Descrizione
    IsRundownEvent Boolean True se si tratta di un evento di rundown. False se segnala un nuovo router del dispositivo.
    IsNewDeviceRouter Boolean True se segnala una porta di un nuovo router del dispositivo. False se segnala una modifica dello stato della porta. Per gli eventi di rundown, è anche false.
    DomainID HexUInt32 ID di dominio di questo router del dispositivo.
    TopologyID UInt8FixedArray(7) ID topologia a 7 byte del router del dispositivo.
    AdapterNumber UInt8 Registro dello spazio di configurazione della scheda "Adapter Number" ADP_CS_3.
    AdapterType HexUInt32 Registrare lo spazio di configurazione dell'adattatore ADP_CS_2[23..0]. Combina i valori di "Adapter Type Protocol", "Adapter Type Version" e "Adapter Type Sub-Type".

    Riferimento specifico: "Tabella 8-9. Attributi di base dello spazio di configurazione della scheda e "Tabella 8-10. Tipi di adattatore"

  8. Evento InterDomainPeerInformation

    Proprietà Tipo di valore Descrizione
    IsRundownEvent Boolean True se si tratta di un evento di rundown.
    DomainID HexUInt32 ID di dominio di questo router del dispositivo.
    TopologyID UInt8FixedArray(7) ID topologia a 7 byte del router del dispositivo.
    Lane0AdapterNumber UInt8 Numero dell'adattatore lane 0 della porta locale. Uguale a Lane0AdapterNumber dell'evento

    "PortInformation".Può essere usato insieme alle proprietà "DomainID" e "TopologyID" sopra per trovare l'evento "PortInformation" corrispondente.
    LocalDomainUUID GUID UUID di dominio del dominio locale in una connessione tra domini.
    RemoteDomainUUID GUID UUID di dominio del dominio remoto in una connessione tra domini.
    LocalRouteString UInt8FixedArray(7) Stringa di route per la porta locale. È nel formato ID topologia 7-UINT8.
    RemoteRouteString UInt8FixedArray(7) Stringa di route per la porta remota. È nel formato ID topologia 7-UINT8
    MaxHopID UInt16 Proprietà "MaxHopID" dalle proprietà interdominie restituite dal peer remoto.

  9. Dispositivo eventoRouterRemoval

    Proprietà Tipo di valore Descrizione
    DomainID HexUInt32 ID di dominio del router del dispositivo.
    TopologyID UInt8FixedArray(7) ID topologia a 7 byte del router del dispositivo.

Thunderbolt è un marchio di Intel Corporation o delle sue filiali.