Freigeben über

TraceLogging USB4-Rundownereignisse™

  • Artikel

Die USB4-Hostrouter- und Geräteroutertreiber geben TraceLogging-Ereignisse aus, um den Status der Domäne zu melden. Diese Ereignisse werden als Ausführungsereignisse bezeichnet und werden von den Treibern gemeldet, wenn eine ETW-Ablaufverfolgungssitzung für die folgenden Ablaufverfolgungsanbieter aktiviert ist. Diese Ereignisse beschreiben die Domäne über eine Reihe von Ereignissen. Nachdem die Ausführungsereignisse ausgegeben wurden, melden die USB4-Treiber weiterhin Ereignisse zur Routeraufzählung und Entfernung.

ETW-Anbietername: „Microsoft.Windows.USB.USB4.HostRouter“ ETW-Anbieter-GUID: {575BA31F-2B45-58C2-64FD-F5DC757B6137}

ETW-Anbietername: „Microsoft.Windows.USB.USB4.DeviceRouter“ ETW-Anbieter-GUID: {AE795D36-2B11-5EFB-C7E0-5D552BC55D6C}

In den folgenden Tabellen werden einige TraceLogging-Ereignisse von Interesse beschrieben.

  1. Ereignis RundownStart und RundownComplete sind Markierungsereignisse, um Start und Ende von Ausführungsereignissen zu kennzeichnen. Sie tragen keine Ereigniseigenschaften oder Nutzlast mit sich.

  2. Ereignis DeviceRouterInformation

    Eigenschaft Werttyp BESCHREIBUNG
    IsRundownEvent Boolean True, wenn es sich um ein Ausführungsereignis handelt. False, wenn es einen neuen Geräterouter meldet.
    DomainID HexUInt32 Die Domänen-ID dieses Geräterouters.
    TopologyID UInt8FixedArray(7) Die 7-Byte-Topologie-ID dieses Geräterouters.
    DeviceInstancePath WideString Der PnP-zugewiesene Geräteinstanzpfad des Geräterouters.

    Es kann verwendet werden, um die Eigenschaftsdaten von DEVPKEY_Device_InstanceId abzugleichen, die PnP-APIs im Unified Device-Eigenschaftsmodell zurückgegeben werden.
    VendorId HexUInt16 Herstellerkennung
    ProductId HexUInt16 Product ID
    AsciiVendorName String Der Anbietername in ASCII. Es wird im Kapitel „ASCII-Anbieternameeintrag“ der USB4-DROM-Spezifikation definiert.
    AsciiModelName String Der Modellname in ASCII. Es wird im Kapitel „ASCII-Modellnameeintrag“ der USB4-DROM-Spezifikation definiert.
    DeviceID HexUInt16 Bei Thunderbolt™ 3 ist dies das Feld „VendorId“ im Thunderbolt™ 3-Kopfzeilenabschnitt.
    Bei USB4 ist dies das Feld „idVendor“ im Product Descriptor Entry.
    ModelID HexUInt16 Bei Thunderbolt™ 3 ist dies das Feld „Modell-ID“ im Thunderbolt™ 3-Kopfzeilenabschnitt.
    Bei USB4 ist dies das Feld „idProduct“ im Product Descriptor Entry.
    UUID HexUInt64 Das Gerät UUID. Bei USB4 ist dies die UUID in den Registern ROUTER_CS_7 und ROUTER_CS_8, die von der USB4-Spezifikation definiert sind.
    DeviceFirmwareVersion HexUInt32 Die Firmwareversion des Geräts.

  3. Ereignis PortInformation

    Eigenschaft Werttyp BESCHREIBUNG
    IsRundownEvent Boolean True, wenn es sich um ein Ausführungsereignis handelt. False, wenn es einen neuen Geräterouter meldet.
    IsNewDeviceRouter Boolean True, wenn ein Port eines neuen Geräterouters gemeldet wird. False, wenn eine Änderung des Portstatus gemeldet wird. Bei Ausführungsereignissen ist es auch false.
    DomainID HexUInt32 Die Domänen-ID dieses Geräterouters.
    TopologyID UInt8FixedArray(7) Die 7-Byte-Topologie-ID dieses Geräterouters.
    IsDFP Boolean True, wenn der zugeordnete Port DFP ist. False, wenn es UFP ist.
    Lane0AdapterNumber UInt8 Die „Adapternummer“ aus dem Adapterkonfigurationsbereich registriert ADP_CS_3.
    Lane1AdapterNumber UInt8 Die „Adapternummer“ aus dem Adapterkonfigurationsbereich registriert ADP_CS_3.
    DownstreamRouterDomainID HexUInt32 Die Domänen-ID des nachgeschalteten Geräterouters.
    DownstreamRouterTopologyID UInt8FixedArray(7) Die 7-Byte-Topologie-ID des nachgeschalteten Geräterouters. Alle Nullen, wenn kein Geräterouter nachgeschaltet ist.
    SupportedLinkSpeeds HexUInt8 Der Wert aus der Konfigurationsfunktion „Lane Adapter“ registriert LANE_ADP_CS_0[19..16] „Unterstützte Link-Geschwindigkeiten“.
    SupportedLinkWidths HexUInt8 Der Wert aus der Konfigurationsfunktion „Lane Adapter“ registriert LANE_ADP_CS_0[25..20] „Unterstützte Link-Breiten“.
    CurrentLinkSpeed HexUInt8 Der Wert aus der Konfigurationsfunktion „Lane Adapter“ registriert LANE_ADP_CS_1[19..16] „Aktuelle Link-Geschwindigkeit“.
    NegotiatedLinkWidth HexUInt8 Der Wert aus der Konfigurationsfunktion „Lane Adapter“ registriert LANE_ADP_CS_1[25..20] „Ausgehandelte Link-Breite“.
    TargetLinkSpeed HexUInt8 Der Wert aus der Konfigurationsfunktion „Lane Adapter“ registriert LANE_ADP_CS_1[3..0] „Ziellink-Geschwindigkeit“.
    TargetLinkWidth HexUInt8 Der Wert aus der Konfigurationsfunktion „Lane Adapter“ registriert LANE_ADP_CS_1[9..4] „Ziellink-Breite“.
    AdapterState HexUInt8 Der Wert aus der Konfigurationsfunktion „Lane Adapter“ registriert LANE_ADP_CS_1[29..26] „Adapter-Status“.
    LaneBonded Boolean Gibt an, ob die Bahnen dieses Ports gebunden sind.
    CableUsbVersion Boolean Der Wert aus der Portfunktion registriert PORT_CS_18[7..0] „Kabel USB-Version“.
    LinkCLxSupport Boolean Der Wert aus der Portfunktion registriert PORT_CS_18[10] „Link CLx-Unterstützung (LCL)“.
    Tbt3CompatibleMode Boolean Der Wert aus der Portfunktion registriert PORT_CS_18[9] „TBT3-Kompatibler Modus (TCM)“.

  4. Ereignis PCIeAdapterInformation

    Eigenschaft Werttyp BESCHREIBUNG
    IsRundownEvent Boolean True, wenn es sich um ein Ausführungsereignis handelt. False, wenn es einen neuen Geräterouter meldet.
    IsNewDeviceRouter Boolean True, wenn ein Port eines neuen Geräterouters gemeldet wird. False, wenn eine Änderung des Portstatus gemeldet wird. Bei Ausführungsereignissen ist es auch false.
    DomainID HexUInt32 Die Domänen-ID dieses Geräterouters.
    TopologyID UInt8FixedArray(7) Die 7-Byte-Topologie-ID dieses Geräterouters.
    AdapterNumber Uint8 Die „Adapternummer“ aus dem Adapterkonfigurationsbereich registriert ADP_CS_3.
    AdapterType HexUInt32 Adapterkonfigurationsraum registriert ADP_CS_2[23..0]. Er kombiniert die Werte des „Adaptertyp-Protokolls“, der „Adaptertyp-Version“ und des „Adaptertyp-Untertyps“.

    Spezifikationsreferenz: „Tabelle 8-9. Basisattribute des Adapterkonfigurationsraums“ und „Tabelle 8-10. Adaptertypen“
    IsDownstream Boolean True, wenn es sich um einen nachgeschalteten PCIe-Adapter handelt. False, wenn es vorgeschaltet ist.
    IsTunneled Boolean True, wenn der Protokolldatenverkehr getunnelt wird.

  5. Ereignis DPAdapterInformation

    Eigenschaft Werttyp BESCHREIBUNG
    IsRundownEvent Boolean True, wenn es sich um ein Ausführungsereignis handelt. False, wenn es einen neuen Geräterouter meldet.
    IsNewDeviceRouter Boolean True, wenn ein Port eines neuen Geräterouters gemeldet wird. False, wenn eine Änderung des Portstatus gemeldet wird. Bei Ausführungsereignissen ist es auch false.
    DomainID HexUInt32 Die Domänen-ID dieses Geräterouters.
    TopologyID Uint8FixedArray(7) Die 7-Byte-Topologie-ID dieses Geräterouters.
    AdapterNumber Uint8 Die „Adapternummer“ aus dem Adapterkonfigurationsbereich registriert ADP_CS_3.
    AdapterType HexUInt32 Adapterkonfigurationsraum registriert ADP_CS_2[23..0]. Er kombiniert die Werte des „Adaptertyp-Protokolls“, der „Adaptertyp-Version“ und des „Adaptertyp-Untertyps“.

    Spezifikationsreferenz: „Tabelle 8-9. Basisattribute des Adapterkonfigurationsraums“ und „Tabelle 8-10. Adaptertypen“
    IsDPOut Boolean True, wenn es sich um einen DP Out-Adapter handelt. False, wenn es sich um DP In handelt.
    IsTunneled Boolean True, wenn der Protokolldatenverkehr getunnelt wird.
    MaximalLinkRate HexUInt8 Der Wert des DP-Adapterkonfigurationsraums registriert DP_COMMON_CAP[11..8] „Maximale Linkrate“.
    MaximalLinkCount HexUInt8 Der Wert des DP-Adapterkonfigurationsraums registriert DP_COMMON_CAP[14..12] „Maximale Linkanzahl“.

  6. Ereignis USB3AdapterInformation

    Eigenschaft Werttyp BESCHREIBUNG
    IsRundownEvent Boolean True, wenn es sich um ein Ausführungsereignis handelt. False, wenn es einen neuen Geräterouter meldet.
    IsNewDeviceRouter Boolean True, wenn ein Port eines neuen Geräterouters gemeldet wird. False, wenn eine Änderung des Portstatus gemeldet wird. Bei Ausführungsereignissen ist es auch false.
    DomainID HexUInt32 Die Domänen-ID dieses Geräterouters.
    TopologyID UInt8FixedArray(7) Die 7-Byte-Topologie-ID dieses Geräterouters.
    AdapterNumber UInt8 Die „Adapternummer“ aus dem Adapterkonfigurationsbereich registriert ADP_CS_3.
    AdapterType HexUInt32 Adapterkonfigurationsraum registriert ADP_CS_2[23..0]. Er kombiniert die Werte des „Adaptertyp-Protokolls“, der „Adaptertyp-Version“ und des „Adaptertyp-Untertyps“.

    Spezifikationsreferenz: „Tabelle 8-9. Basisattribute des Adapterkonfigurationsraums“ und „Tabelle 8-10. Adaptertypen“
    IsDownstream Boolean True, wenn es sich um einen nachgeschalteten USB 3.x-Adapter handelt. False, wenn es vorgeschaltet ist.
    IsTunneled Boolean True, wenn der Protokolldatenverkehr getunnelt wird.
    ActualLinkRate HexUInt8 Der Wert von USB 3.x-Adapterkonfigurationsraum registriert ADP_USB3_CS_4[6..0] „Tatsächliche Linkrate“.

  7. Ereignis OtherAdapterInformation

    Eigenschaft Werttyp BESCHREIBUNG
    IsRundownEvent Boolean True, wenn es sich um ein Ausführungsereignis handelt. False, wenn es einen neuen Geräterouter meldet.
    IsNewDeviceRouter Boolean True, wenn ein Port eines neuen Geräterouters gemeldet wird. False, wenn eine Änderung des Portstatus gemeldet wird. Bei Ausführungsereignissen ist es auch false.
    DomainID HexUInt32 Die Domänen-ID dieses Geräterouters.
    TopologyID UInt8FixedArray(7) Die 7-Byte-Topologie-ID dieses Geräterouters.
    AdapterNumber UInt8 Die „Adapternummer“ aus dem Adapterkonfigurationsbereich registriert ADP_CS_3.
    AdapterType HexUInt32 Adapterkonfigurationsraum registriert ADP_CS_2[23..0]. Er kombiniert die Werte des „Adaptertyp-Protokolls“, der „Adaptertyp-Version“ und des „Adaptertyp-Untertyps“.

    Spezifikationsreferenz: „Tabelle 8-9. Basisattribute des Adapterkonfigurationsraums“ und „Tabelle 8-10. Adaptertypen“

  8. Ereignis InterDomainPeerInformation

    Eigenschaft Werttyp BESCHREIBUNG
    IsRundownEvent Boolean True, wenn es sich um ein Ausführungsereignis handelt.
    DomainID HexUInt32 Die Domänen-ID dieses Geräterouters.
    TopologyID UInt8FixedArray(7) Die 7-Byte-Topologie-ID dieses Geräterouters.
    Lane0AdapterNumber UInt8 Die Lane 0-Adapternummer des lokalen Ports. Identisch mit Lane0AdapterNumber des „PortInformation“-Ereignisses.

    Es kann zusammen mit den oben genannten Eigenschaften „DomainID“ und „TopologyID“ verwendet werden, um das entsprechende „PortInformation“-Ereignis zu finden.
    LocalDomainUUID GUID Die Domänen-UUID der lokalen Domäne in einer domänenübergreifenden Verbindung.
    RemoteDomainUUID GUID Die Domänen-UUID der Remote-Domäne in einer domänenübergreifenden Verbindung.
    LocalRouteString UInt8FixedArray(7) Die Routenzeichenfolge für den lokalen Port. Sie befindet sich im 7-UINT8-Topologie-ID-Format.
    RemoteRouteString UInt8FixedArray(7) Die Routenzeichenfolge für den Remote-Port. Sie befindet sich im 7-UINT8-Topologie-ID-Format.
    MaxHopID UInt16 Die Eigenschaft „MaxHopID“ aus den Domäneneigenschaften, die vom Remote-Peer zurückgegeben wird.

  9. Event DeviceRouterRemoval

    Eigenschaft Werttyp BESCHREIBUNG
    DomainID HexUInt32 Die Domänen-ID des Geräterouters.
    TopologyID UInt8FixedArray(7) Die 7-Byte-Topologie-ID des Geräterouters.

Thunderbolt ist eine Marke der Intel Corporation oder ihrer Tochtergesellschaften.