Поделиться через

События очистки USB4™ traceLogging

  • Статья

Драйверы маршрутизатора узла USB4 и маршрутизатора устройств выдают события TraceLogging , чтобы сообщить о состоянии домена. Эти события называются событиями очистки и сообщаются драйверами при включении сеанса трассировки windows для следующих поставщиков трассировки. Эти события описывают домен с помощью ряда событий. После создания событий очистки драйверы USB4 продолжат сообщать о событиях при перечислении и удалении маршрутизатора.

Имя поставщика трассировки событий Windows: "Microsoft.Windows.USB.USB4.HostRouter" GUID поставщика ETW: {575BA31F-2B45-58C2-64FD-F5DC757B6137}

Имя поставщика трассировки событий Windows: "Microsoft.Windows.USB.USB4.DeviceRouter" GUID поставщика ETW: {AE795D36-2B11-5EFB-C7E0-5D552BC55D6C}

В следующих таблицах описаны некоторые интересующие события TraceLogging.

  1. События RundownStart и RundownComplete — это события маркеров, обозначающие начало и конец событий очистки. Они не содержат никаких свойств событий или полезных данных.

  2. Event DeviceRouterInformation

    Свойство Тип значения Описание
    IsRundownEvent Логическое Значение true, если это событие является событием очистки. False, если он сообщает о новом маршрутизаторе устройства.
    DomainID HexUInt32 Идентификатор домена этого маршрутизатора устройства.
    Идентификатор топологии UInt8FixedArray(7) Идентификатор 7-байтовой топологии этого маршрутизатора устройства.
    DeviceInstancePath WideString Путь к экземпляру устройства, назначаемого PnP, маршрутизатора устройства.

    Его можно использовать для сопоставления данных свойства DEVPKEY_Device_InstanceId, которые возвращаются API-интерфейсами PnP в модели свойств единого устройства .
    VendorId HexUInt16 Идентификатор поставщика
    ProductId HexUInt16 Product ID
    AsciiVendorName Строка Имя поставщика в ASCII. Он определяется в разделе AsCII Vendor Entry (Запись имени поставщика ASCII) спецификации USB4 DROM.
    AsciiModelName Строка Имя модели в ASCII. Она определена в разделе AsCII Model Name Entry (Запись имени модели ASCII) спецификации USB4 DROM.
    DeviceID HexUInt16 Для Thunderbolt™ 3 это поле "VendorId" в разделе заголовка Thunderbolt™ 3.
    Для USB4 это поле idVendor в записи дескриптора продукта.
    ModelID HexUInt16 Для Thunderbolt™ 3 это поле "Идентификатор модели" в разделе заголовка Thunderbolt™ 3.
    Для USB4 это поле idProduct в записи дескриптора продукта.
    UUID HexUInt64 UUID устройства. Для USB4 это UUID в ROUTER_CS_7 и ROUTER_CS_8 регистры, определенные спецификацией USB4.
    DeviceFirmwareVersion HexUInt32 Версия встроенного ПО устройства.

  3. Event PortInformation

    Свойство Тип значения Описание
    IsRundownEvent Логическое Значение true, если это событие является событием очистки. False, если он сообщает о новом маршрутизаторе устройства.
    IsNewDeviceRouter Логическое Значение true, если сообщается о порте нового маршрутизатора устройства. False, если сообщает об изменении состояния порта. Для событий очистки он также имеет значение false.
    DomainID HexUInt32 Идентификатор домена этого маршрутизатора устройства.
    Идентификатор топологии UInt8FixedArray(7) Идентификатор 7-байтовой топологии этого маршрутизатора устройства.
    IsDFP Логическое Значение true, если связанный порт — DFP. False, если это UFP.
    Lane0AdapterNumber UInt8 "Номер адаптера" из регистра пространства конфигурации адаптера ADP_CS_3.
    Lane1AdapterNumber UInt8 "Номер адаптера" из регистра пространства конфигурации адаптера ADP_CS_3.
    DownstreamRouterDomainID HexUInt32 Идентификатор домена подчиненного маршрутизатора устройства.
    DownstreamRouterTopologyID UInt8FixedArray(7) Идентификатор 7-байтовой топологии подчиненного маршрутизатора устройства. Все нули, если ни один маршрутизатор устройства не подключен ниже.
    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 Логическое Указывает, связаны ли полосы движения этого порта.
    CableUsbVersion Логическое Значение из регистра возможности порта PORT_CS_18[7..0] "Версия USB кабеля".
    LinkCLxSupport Логическое Значение из регистра port capability PORT_CS_18[10] "Link CLx Support (LCL)".
    Tbt3CompatibleMode Логическое Значение из регистра возможности порта PORT_CS_18[9] "TBT3-Compatible Mode (TCM)".

  4. Событие PCIeAdapterInformation

    Свойство Тип значения Описание
    IsRundownEvent Логическое Значение true, если это событие является событием очистки. False, если он сообщает о новом маршрутизаторе устройства.
    IsNewDeviceRouter Логическое Значение true, если сообщается о порте нового маршрутизатора устройства. False, если сообщает об изменении состояния порта. Для событий очистки он также имеет значение false.
    DomainID HexUInt32 Идентификатор домена этого маршрутизатора устройства.
    Идентификатор топологии UInt8FixedArray(7) Идентификатор 7-байтовой топологии этого маршрутизатора устройства.
    AdapterNumber Uint8 "Номер адаптера" из регистра пространства конфигурации адаптера ADP_CS_3.
    AdapterType HexUInt32 Регистр пространства конфигурации адаптера ADP_CS_2[23..0]. Он объединяет значения "Протокол типа адаптера", "Версия типа адаптера" и "Подтип типа адаптера".

    Справочник по спецификациям: "Таблица 8-9. Базовые атрибуты пространства конфигурации адаптера» и «Таблица 8–10. Типы адаптеров"
    IsDownstream Логическое Значение true, если это нижестоящий адаптер PCIe. Значение false, если оно вышестоящий.
    IsTunneled Логическое Значение true, если трафик протокола туннелирован.

  5. Event DPAdapterInformation

    Свойство Тип значения Описание
    IsRundownEvent Логическое Значение true, если это событие является событием очистки. False, если он сообщает о новом маршрутизаторе устройства.
    IsNewDeviceRouter Логическое Значение true, если сообщается о порте нового маршрутизатора устройства. False, если сообщает об изменении состояния порта. Для событий очистки он также имеет значение false.
    DomainID HexUInt32 Идентификатор домена этого маршрутизатора устройства.
    Идентификатор топологии Uint8FixedArray(7) Идентификатор 7-байтовой топологии этого маршрутизатора устройства.
    AdapterNumber Uint8 "Номер адаптера" из регистра пространства конфигурации адаптера ADP_CS_3.
    AdapterType HexUInt32 Регистр пространства конфигурации адаптера ADP_CS_2[23..0]. Он объединяет значения "Протокол типа адаптера", "Версия типа адаптера" и "Подтип типа адаптера".

    Справочник по спецификациям: "Таблица 8-9. Базовые атрибуты пространства конфигурации адаптера» и «Таблица 8–10. Типы адаптеров"
    IsDPOut Логическое Значение true, если это адаптер dp out. False, если это DP In.
    IsTunneled Логическое Значение true, если трафик протокола туннелирован.
    MaximalLinkRate HexUInt8 Значение из регистра конфигурации адаптера DP DP_COMMON_CAP[11..8] "Максимальная скорость канала".
    MaximalLinkCount HexUInt8 Значение из регистра пространства конфигурации адаптера DP DP_COMMON_CAP[14..12] "Максимальное число ссылок".

  6. Событие USB3AdapterInformation

    Свойство Тип значения Описание
    IsRundownEvent Логическое Значение true, если это событие является событием очистки. False, если он сообщает о новом маршрутизаторе устройства.
    IsNewDeviceRouter Логическое Значение true, если сообщается о порте нового маршрутизатора устройства. False, если сообщает об изменении состояния порта. Для событий очистки он также имеет значение false.
    DomainID HexUInt32 Идентификатор домена этого маршрутизатора устройства.
    Идентификатор топологии UInt8FixedArray(7) Идентификатор 7-байтовой топологии этого маршрутизатора устройства.
    AdapterNumber UInt8 "Номер адаптера" из регистра пространства конфигурации адаптера ADP_CS_3.
    AdapterType HexUInt32 Регистр пространства конфигурации адаптера ADP_CS_2[23..0]. Он объединяет значения "Протокол типа адаптера", "Версия типа адаптера" и "Подтип типа адаптера".

    Справочник по спецификациям: "Таблица 8-9. Базовые атрибуты пространства конфигурации адаптера» и «Таблица 8–10. Типы адаптеров"
    IsDownstream Логическое Значение true, если это нижестоящий адаптер USB 3.x. Значение false, если оно вышестоящий.
    IsTunneled Логическое Значение true, если трафик протокола туннелирован.
    ActualLinkRate HexUInt8 Значение из регистра конфигурации адаптера USB 3.x ADP_USB3_CS_4[6..0] "Фактическая скорость канала".

  7. Event OtherAdapterInformation

    Свойство Тип значения Описание
    IsRundownEvent Логическое Значение true, если это событие является событием очистки. False, если он сообщает о новом маршрутизаторе устройства.
    IsNewDeviceRouter Логическое Значение true, если сообщается о порте нового маршрутизатора устройства. False, если сообщает об изменении состояния порта. Для событий очистки он также имеет значение false.
    DomainID HexUInt32 Идентификатор домена этого маршрутизатора устройства.
    Идентификатор топологии UInt8FixedArray(7) Идентификатор 7-байтовой топологии этого маршрутизатора устройства.
    AdapterNumber UInt8 "Номер адаптера" из регистра пространства конфигурации адаптера ADP_CS_3.
    AdapterType HexUInt32 Регистр пространства конфигурации адаптера ADP_CS_2[23..0]. Он объединяет значения "Протокол типа адаптера", "Версия типа адаптера" и "Подтип типа адаптера".

    Справочник по спецификациям: "Таблица 8-9. Базовые атрибуты пространства конфигурации адаптера» и «Таблица 8–10. Типы адаптеров"

  8. Event InterDomainPeerInformation

    Свойство Тип значения Описание
    IsRundownEvent Логическое Значение true, если это событие является событием очистки.
    DomainID HexUInt32 Идентификатор домена этого маршрутизатора устройства.
    Идентификатор топологии UInt8FixedArray(7) Идентификатор 7-байтовой топологии этого маршрутизатора устройства.
    Lane0AdapterNumber UInt8 Номер адаптера lane 0 локального порта. То же, что и Lane0AdapterNumber события PortInformation.

    Его можно использовать вместе со свойствами DomainID и TopologyID выше, чтобы найти соответствующее событие PortInformation.
    LocalDomainUUID GUID UUID домена локального домена в междоменного подключения.
    RemoteDomainUUID GUID Идентификатор UUID удаленного домена в междоменного подключения.
    LocalRouteString UInt8FixedArray(7) Строка маршрута для локального порта. Он находится в формате идентификатора топологии 7-UINT8.
    RemoteRouteString UInt8FixedArray(7) Строка маршрута для удаленного порта. Он находится в формате идентификатора топологии 7-UINT8.
    MaxHopID UInt16 Свойство MaxHopID из блока свойств между доменами, возвращаемое удаленным одноранговым элементом.

  9. Event DeviceRouterRemoval

    Свойство Тип значения Описание
    DomainID HexUInt32 Идентификатор домена маршрутизатора устройства.
    TopologyID UInt8FixedArray(7) 7-байтовый идентификатор топологии маршрутизатора устройства.

Thunderbolt является товарным знаком корпорации Intel или ее дочерних компаний.