TraceLogging USB4™ ランダウン イベント

  • [アーティクル]

USB4ホスト ルーターとデバイス ルーター ドライバーは、 ドメインの状態を報告するTraceLoggingイベント を出力します。 これらのイベントはランダウン イベントと呼ばれ、次のトレース プロバイダーの ETW トレース セッションが有効なときにドライバーによって報告されます。 これらのイベントは、一連のイベントを通じてドメインを記述します。 ランダウン イベントが生成された後、USB4 ドライバーは、ルーターの列挙と削除に関するイベントを引き続き報告します。

ETW プロバイダー名: "Microsoft.Windows.USB.USB4.HostRouter" ETW プロバイダー GUID: {575BA31F-2B45-58C2-64FD-F5DC757B6137}

ETW プロバイダー名: "Microsoft.Windows.USB.USB4.DeviceRouter" ETW プロバイダー GUID: {AE795D36-2B11-5EFB-C7E0-5D552BC55D6C}

次の表では、対象となる TraceLogging イベントについて説明します。

  1. イベント RundownStart および RundownComplete は、ランダウン イベントの開始と終了を示すマーカー イベントです。 これらはイベント プロパティやペイロードを伴いません。

  2. イベント DeviceRouterInformation

    プロパティ 値の型 説明
    IsRundownEvent Boolean ランダウン イベントの場合は True。 新しいデバイス ルーターを報告している場合は False。
    DomainID HexUInt32 このデバイス ルーターのドメイン ID。
    TopologyID UInt8FixedArray(7) このデバイス ルーターの 7 バイトのトポロジ ID。
    DeviceInstancePath WideString デバイス ルーターの、PnP によって割り当てられたデバイス インスタンスのパス。

    これは、統合デバイス プロパティ モデル の PnP API が返す DEVPKEY_Device_InstanceId プロパティデータを照合するために使用できます。
    VendorId HexUInt16 ベンダー ID
    ProductId HexUInt16 製品 ID
    AsciiVendorName String ASCII のベンダー名。 これは、USB4 DROM 仕様の「ASCII ベンダ名エントリ」の章で定義されています。
    AsciiModelName String ASCII のモデル名。 これは、USB4 DROM 仕様の「ASCII モデル名エントリ」の章で定義されています。
    DeviceID HexUInt16 Thunderbolt™ 3 の場合、これは Thunderbolt™ 3 ヘッダー セクションの "VendorId" フィールドです。
    USB4 の場合、これは製品記述子エントリの "idVendor" フィールドです。
    ModelID HexUInt16 Thunderbolt™ 3 の場合、これは Thunderbolt™ 3 ヘッダー セクションの "Model ID" フィールドです。
    USB4 の場合、これは製品記述子エントリの "idProduct" フィールドです。
    UUID HexUInt64 デバイスの UUID。 USB4 の場合、これは USB4 仕様で定義されている ROUTER_CS_7 および ROUTER_CS_8 レジスタ内の UUID です。
    DeviceFirmwareVersion HexUInt32 デバイス ファームウェアのバージョン。

  3. イベント PortInformation

    プロパティ 値の型 説明
    IsRundownEvent Boolean ランダウン イベントの場合は True。 新しいデバイス ルーターを報告している場合は False。
    IsNewDeviceRouter Boolean 新しいデバイス ルーターのポートを報告している場合は True。 ポートの状態変更を報告している場合は False。 ランダウン イベントの場合も、false です。
    DomainID HexUInt32 このデバイス ルーターのドメイン ID。
    TopologyID UInt8FixedArray(7) このデバイス ルーターの 7 バイトのトポロジ ID。
    IsDFP Boolean 関連付けられているポートが DFP の場合は True。 UFP の場合は False。
    Lane0AdapterNumber UInt8 アダプター構成領域レジスター ADP_CS_3 の "アダプター番号"。
    Lane1AdapterNumber UInt8 アダプター構成領域レジスター ADP_CS_3 の "アダプター番号"。
    DownstreamRouterDomainID HexUInt32 ダウンストリーム デバイス ルーターのドメイン ID。
    DownstreamRouterTopologyID UInt8FixedArray(7) ダウンストリーム デバイス ルーターの 7 バイトのトポロジ ID。 デバイス ルーターがダウンストリームに接続されていない場合はすべてゼロ。
    SupportedLinkSpeeds HexUInt8 レーン アダプター構成機能レジスター LANE_ADP_CS_0 [19.. 16] "サポートされるリンク速度" からの値。
    SupportedLinkWidths HexUInt8 レーン アダプター構成機能レジスター LANE_ADP_CS_0 [25..20] "サポートされるリンク幅" からの値。
    CurrentLinkSpeed HexUInt8 レーン アダプター構成機能レジスター LANE_ADP_CS_1[19..16] "現在のリンク速度" からの値。
    NegotiatedLinkWidth HexUInt8 レーン アダプター構成機能レジスター LANE_ADP_CS_1[25..20] "ネゴシエートされたリンク幅" からの値。
    TargetLinkSpeed HexUInt8 レーン アダプター構成機能レジスター LANE_ADP_CS_1[3..0] "ターゲット リンク速度" からの値。
    TargetLinkWidth HexUInt8 レーン アダプター構成機能レジスター LANE_ADP_CS_1[9..4] "ターゲット リンク幅" からの値。
    AdapterState HexUInt8 レーン アダプター構成機能レジスター LANE_ADP_CS_1[29..26] "アダプター状態" からの値。
    LaneBonded Boolean このポートのレーンが結合されているかどうかを示します。
    CableUsbVersion Boolean ポート機能レジスター PORT_CS_18[7..0] "ケーブル USB バージョン" からの値。
    LinkCLxSupport Boolean ポート機能レジスター PORT_CS_18[10] "リンク CLx サポート (LCL)" からの値。
    Tbt3CompatibleMode Boolean ポート機能レジスター PORT_CS_18[9] "TBT3 互換モード (TCM)" からの値。

  4. イベント PCIeAdapterInformation

    プロパティ 値の型 説明
    IsRundownEvent Boolean ランダウン イベントの場合は True。 新しいデバイス ルーターを報告している場合は False。
    IsNewDeviceRouter Boolean 新しいデバイス ルーターのポートを報告している場合は True。 ポートの状態変更を報告している場合は False。 ランダウン イベントの場合も、false です。
    DomainID HexUInt32 このデバイス ルーターのドメイン ID。
    TopologyID UInt8FixedArray(7) このデバイス ルーターの 7 バイトのトポロジ ID。
    AdapterNumber Uint8 アダプター構成領域レジスター ADP_CS_3 の "アダプター番号"。
    AdapterType HexUInt32 アダプター構成領域レジスター ADP_CS_2[23.. 0]。 "アダプターの種類のプロトコル"、"アダプターの種類のバージョン"、および "アダプターの種類のサブタイプ" の値を結合します。

    仕様参照: "表 8-9. アダプター構成領域の基本属性" と "表 8-10. アダプターの種類"
    IsDownstream Boolean ダウンストリームの PCIe アダプターの場合は True。 アップストリームの場合は False。
    IsTunneled Boolean プロトコル トラフィックがトンネリングされている場合は True。

  5. イベント DPAdapterInformation

    プロパティ 値の型 説明
    IsRundownEvent Boolean ランダウン イベントの場合は True。 新しいデバイス ルーターを報告している場合は False。
    IsNewDeviceRouter Boolean 新しいデバイス ルーターのポートを報告している場合は True。 ポートの状態変更を報告している場合は False。 ランダウン イベントの場合も、false です。
    DomainID HexUInt32 このデバイス ルーターのドメイン ID。
    TopologyID Uint8FixedArray(7) このデバイス ルーターの 7 バイトのトポロジ ID。
    AdapterNumber Uint8 アダプター構成領域レジスター ADP_CS_3 の "アダプター番号"。
    AdapterType HexUInt32 アダプター構成領域レジスター ADP_CS_2[23.. 0]。 "アダプターの種類のプロトコル"、"アダプターの種類のバージョン"、および "アダプターの種類のサブタイプ" の値を結合します。

    仕様参照: "表 8-9. アダプター構成領域の基本属性" と "表 8-10. アダプターの種類"
    IsDPOut Boolean DP Out アダプターの場合は True。 DP In の場合は False。
    IsTunneled Boolean プロトコル トラフィックがトンネリングされている場合は True。
    MaximalLinkRate HexUInt8 DP アダプター構成空間レジスター DP_COMMON_CAP[11..8] "最大リンク率" からの値。
    MaximalLinkCount HexUInt8 DP アダプター構成空間レジスター DP_COMMON_CAP[14..12] "最大リンク カウント" からの値。

  6. イベント USB3AdapterInformation

    プロパティ 値の型 説明
    IsRundownEvent Boolean ランダウン イベントの場合は True。 新しいデバイス ルーターを報告している場合は False。
    IsNewDeviceRouter Boolean 新しいデバイス ルーターのポートを報告している場合は True。 ポートの状態変更を報告している場合は False。 ランダウン イベントの場合も、false です。
    DomainID HexUInt32 このデバイス ルーターのドメイン ID。
    TopologyID UInt8FixedArray(7) このデバイス ルーターの 7 バイトのトポロジ ID。
    AdapterNumber UInt8 アダプター構成領域レジスター ADP_CS_3 の "アダプター番号"。
    AdapterType HexUInt32 アダプター構成領域レジスター ADP_CS_2[23.. 0]。 "アダプターの種類のプロトコル"、"アダプターの種類のバージョン"、および "アダプターの種類のサブタイプ" の値を結合します。

    仕様参照: "表 8-9. アダプター構成領域の基本属性" と "表 8-10. アダプターの種類"
    IsDownstream Boolean ダウンストリーム USB 3.x アダプターの場合は True。 アップストリームの場合は False。
    IsTunneled Boolean プロトコル トラフィックがトンネリングされている場合は True。
    ActualLinkRate HexUInt8 USB 3.x アダプター構成空間レジスター ADP_USB3_CS_4[6..0] "実際のリンク率" からの値。

  7. イベント OtherAdapterInformation

    プロパティ 値の型 説明
    IsRundownEvent Boolean ランダウン イベントの場合は True。 新しいデバイス ルーターを報告している場合は False。
    IsNewDeviceRouter Boolean 新しいデバイス ルーターのポートを報告している場合は True。 ポートの状態変更を報告している場合は False。 ランダウン イベントの場合も、false です。
    DomainID HexUInt32 このデバイス ルーターのドメイン ID。
    TopologyID UInt8FixedArray(7) このデバイス ルーターの 7 バイトのトポロジ ID。
    AdapterNumber UInt8 アダプター構成領域レジスター ADP_CS_3 の "アダプター番号"。
    AdapterType HexUInt32 アダプター構成領域レジスター ADP_CS_2[23.. 0]。 "アダプターの種類のプロトコル"、"アダプターの種類のバージョン"、および "アダプターの種類のサブタイプ" の値を結合します。

    仕様参照: "表 8-9. アダプター構成領域の基本属性" と "表 8-10. アダプターの種類"

  8. イベント InterDomainPeerInformation

    プロパティ 値の型 説明
    IsRundownEvent Boolean ランダウン イベントの場合は True。
    DomainID HexUInt32 このデバイス ルーターのドメイン ID。
    TopologyID UInt8FixedArray(7) このデバイス ルーターの 7 バイトのトポロジ ID。
    Lane0AdapterNumber UInt8 ローカル ポートのレーン 0 アダプター番号。 "PortInformation" イベントの Lane0AdapterNumber と同じです。

    上記の "DomainID" プロパティと "TopologyID" プロパティと共に使用して、一致する "PortInformation" イベントを検索できます。
    LocalDomainUUID GUID ドメイン間接続のローカル ドメインのドメイン UUID。
    RemoteDomainUUID GUID ドメイン間接続のリモート ドメインのドメイン UUID。
    LocalRouteString UInt8FixedArray(7) ローカル ポートのルート文字列。 7-UINT8 トポロジ ID 形式です。
    RemoteRouteString UInt8FixedArray(7) リモート ポートのルート文字列。 7-UINT8 トポロジ ID 形式です
    MaxHopID UInt16 リモート ピアによって返されるドメイン間プロパティ ブロックの "MaxHopID" プロパティ。

  9. イベント DeviceRouterRemoval

    プロパティ 値の型 説明
    DomainID HexUInt32 デバイス ルーターのドメイン ID。
    TopologyID UInt8FixedArray(7) デバイス ルーターの 7 バイトのトポロジ ID。

"Thunderbolt は Intel Corporation またはその子会社の商標です。"