Eventos de rundown do TraceLogging USB4™
O roteador de host USB4 e os drivers de roteador de dispositivo emitem eventos TraceLogging para relatar o estado do domínio. Esses eventos são conhecidos como eventos de encerramento e são relatados pelos drivers quando uma sessão de rastreamento ETW para os provedores de rastreamento a seguir está habilitada. Esses eventos descrevem o domínio por meio de uma série de eventos. Depois que os eventos de encerramento forem emitidos, os drivers USB4 continuarão relatando eventos na enumeração e remoção do roteador.
Nome do provedor ETW: GUID do provedor ETW "Microsoft.Windows.USB.USB4.HostRouter": {575BA31F-2B45-58C2-64FD-F5DC757B6137}
Nome do provedor ETW: GUID do provedor ETW "Microsoft.Windows.USB.USB4.DeviceRouter": {AE795D36-2B11-5EFB-C7E0-5D552BC55D6C}
As tabelas a seguir descrevem alguns eventos traceLogging de interesse.
Event RundownStart e RundownComplete são eventos de marcador para indicar o início e o fim dos eventos de rundown. Eles não carregam nenhuma propriedade de evento ou conteúdo com eles.
Event DeviceRouterInformation
Propriedade Tipo de valor Descrição IsRundownEvent Booliano True se for um evento de resumo. False se estiver relatando um novo roteador de dispositivo. DomainID HexUInt32 A ID de domínio deste roteador de dispositivo. TopologyID UInt8FixedArray(7) A ID da topologia de 7 bytes desse roteador de dispositivo. DeviceInstancePath WideString O caminho da instância de dispositivo atribuída por PnP do roteador do dispositivo.
Ele pode ser usado para corresponder aos dados de propriedade DEVPKEY_Device_InstanceId que as APIs PnP no Modelo de Propriedade de Dispositivo Unificado retornam.Vendorid HexUInt16 ID do Fornecedor ProductId HexUInt16 Produto ID AsciiVendorName Cadeia de caracteres O nome do fornecedor no ASCII. Ele é definido no capítulo Entrada de Nome do Fornecedor ASCII da especificação DROM USB4. AsciiModelName Cadeia de caracteres O nome do modelo no ASCII. Ele é definido no capítulo Entrada de Nome do Modelo ASCII da especificação DROM USB4. Deviceid HexUInt16 Para o Thunderbolt™ 3, é o campo "VendorId" na seção cabeçalho Thunderbolt™ 3.
Para USB4, é o campo "idVendor" na Entrada do Descritor de Produto.Modelid HexUInt16 Para o Thunderbolt™ 3, é o campo "ID do modelo" na seção cabeçalho thunderbolt™ 3.
Para USB4, é o campo "idProduct" na Entrada do Descritor de Produto.UUID HexUInt64 O UUID do dispositivo. Para USB4, é a UUID no ROUTER_CS_7 e ROUTER_CS_8 registros definidos pela especificação USB4. DeviceFirmwareVersion HexUInt32 A versão do firmware do dispositivo. PortInformation do evento
Propriedade Tipo de valor Descrição IsRundownEvent Booliano True se for um evento de resumo. False se estiver relatando um novo roteador de dispositivo. IsNewDeviceRouter Booliano True se estiver relatando uma porta de um novo roteador de dispositivo. False se estiver relatando uma alteração status porta. Para eventos de rundown, também é falso. DomainID HexUInt32 A ID de domínio deste roteador de dispositivo. TopologyID UInt8FixedArray(7) A ID da topologia de 7 bytes desse roteador de dispositivo. IsDFP Booliano True se a porta associada for DFP. False se for UFP. Lane0AdapterNumber UInt8 O registro "Número do Adaptador" do espaço de configuração do adaptador ADP_CS_3. Lane1AdapterNumber UInt8 O registro "Número do Adaptador" do espaço de configuração do adaptador ADP_CS_3. DownstreamRouterDomainID HexUInt32 A ID de domínio do roteador de dispositivo downstream. DownstreamRouterTopologyID UInt8FixedArray(7) A ID de topologia de 7 bytes do roteador de dispositivo downstream. Todos os zeros se nenhum roteador de dispositivo estiver conectado downstream. SupportedLinkSpeeds HexUInt8 O valor do registro da funcionalidade de configuração do adaptador de faixa LANE_ADP_CS_0[19..16] "Velocidades de link com suporte". SupportedLinkWidths HexUInt8 O valor do registro da funcionalidade de configuração do adaptador de faixa LANE_ADP_CS_0[25..20] "Larguras de link com suporte". CurrentLinkSpeed HexUInt8 O valor do recurso de configuração do adaptador de faixa registra LANE_ADP_CS_1[19..16] "Velocidade do Link Atual". NegotiatedLinkWidth HexUInt8 O valor do recurso de configuração do adaptador de faixa registra LANE_ADP_CS_1[25..20] "Largura do Link Negociado". TargetLinkSpeed HexUInt8 O valor do recurso de configuração do adaptador de faixa registra LANE_ADP_CS_1[3..0] "Velocidade de link de destino". TargetLinkWidth HexUInt8 O valor do recurso de configuração do adaptador de faixa registra LANE_ADP_CS_1[9..4] "Largura do Link de Destino". AdapterState HexUInt8 O valor do recurso de configuração do adaptador de faixa registra LANE_ADP_CS_1[29..26] "Estado do adaptador". LaneBonded Booliano Indica se as pistas dessa porta estão vinculadas. CableUsbVersion Booliano O valor da capacidade de porta registra PORT_CS_18[7..0] "Versão USB do cabo". LinkCLxSupport Booliano O valor do registro do recurso de porta PORT_CS_18[10] "Vincular suporte CLx (LCL)". Tbt3CompatibleMode Booliano O valor do registro do recurso de porta PORT_CS_18[9] "TCM (Modo Compatível com TBT3)". Evento PCIeAdapterInformation
Propriedade Tipo de valor Descrição IsRundownEvent Booliano True se for um evento de rundown. False se estiver relatando um novo roteador de dispositivo. IsNewDeviceRouter Booliano True se ele estiver relatando uma porta de um novo roteador de dispositivo. False se estiver relatando uma alteração status porta. Para eventos de rundown, ele também é falso. DomainID HexUInt32 A ID de domínio deste roteador de dispositivo. TopologyID UInt8FixedArray(7) A ID de topologia de 7 bytes deste roteador de dispositivo. AdapterNumber Uint8 O registro "Número do Adaptador" do espaço de configuração do adaptador ADP_CS_3. AdapterType HexUInt32 O espaço de configuração do adaptador registra ADP_CS_2[23..0]. Ele combina os valores de "Adapter Type Protocol", "Adapter Type Version" e "Adapter Type Sub-Type".
Referência de especificação: "Tabela 8-9. Atributos básicos do espaço de configuração do adaptador" e "Tabela 8-10. Tipos de adaptador"IsDownstream Booliano True se for um adaptador PCIe downstream. False se for upstream. IsTunneled Booliano True se o tráfego de protocolo estiver em túnel. Evento DPAdapterInformation
Propriedade Tipo de valor Descrição IsRundownEvent Booliano True se for um evento de rundown. False se estiver relatando um novo roteador de dispositivo. IsNewDeviceRouter Booliano True se ele estiver relatando uma porta de um novo roteador de dispositivo. False se estiver relatando uma alteração status porta. Para eventos de rundown, ele também é falso. DomainID HexUInt32 A ID de domínio deste roteador de dispositivo. TopologyID Uint8FixedArray(7) A ID de topologia de 7 bytes deste roteador de dispositivo. AdapterNumber Uint8 O registro "Número do Adaptador" do espaço de configuração do adaptador ADP_CS_3. AdapterType HexUInt32 O espaço de configuração do adaptador registra ADP_CS_2[23..0]. Ele combina os valores de "Adapter Type Protocol", "Adapter Type Version" e "Adapter Type Sub-Type".
Referência de especificação: "Tabela 8-9. Atributos básicos do espaço de configuração do adaptador" e "Tabela 8-10. Tipos de adaptador"IsDPOut Booliano True se for um adaptador DP Out. False se for DP In. IsTunneled Booliano True se o tráfego de protocolo estiver em túnel. MaximalLinkRate HexUInt8 O valor do espaço de configuração do adaptador DP registra DP_COMMON_CAP[11..8] "Taxa de Link Máximo". MaximalLinkCount HexUInt8 O valor do registro de espaço de configuração do adaptador DP DP_COMMON_CAP[14..12] "Contagem máxima de vínculos". Evento USB3AdapterInformation
Propriedade Tipo de valor Descrição IsRundownEvent Booliano True se for um evento de resumo. False se estiver relatando um novo roteador de dispositivo. IsNewDeviceRouter Booliano True se estiver relatando uma porta de um novo roteador de dispositivo. False se estiver relatando uma alteração status porta. Para eventos de rundown, também é falso. DomainID HexUInt32 A ID de domínio deste roteador de dispositivo. TopologyID UInt8FixedArray(7) A ID da topologia de 7 bytes desse roteador de dispositivo. AdapterNumber UInt8 O registro "Número do Adaptador" do espaço de configuração do adaptador ADP_CS_3. AdapterType HexUInt32 Registro de espaço de configuração do adaptador ADP_CS_2[23..0]. Ele combina os valores de "Adapter Type Protocol", "Adapter Type Version" e "Adapter Type Sub-Type".
Referência de especificação: "Tabela 8-9. Atributos básicos do espaço de configuração do adaptador" e "Tabela 8-10. Tipos de adaptador"IsDownstream Booliano True se for um adaptador USB 3.x downstream. False se for upstream. IsTunneled Booliano True se o tráfego de protocolo for encapsulado. ActualLinkRate HexUInt8 O valor do registro de espaço de configuração do adaptador USB 3.x ADP_USB3_CS_4[6..0] "Taxa de Link Real". Evento OtherAdapterInformation
Propriedade Tipo de valor Descrição IsRundownEvent Booliano True se for um evento de resumo. False se estiver relatando um novo roteador de dispositivo. IsNewDeviceRouter Booliano True se estiver relatando uma porta de um novo roteador de dispositivo. False se estiver relatando uma alteração status porta. Para eventos de rundown, também é falso. DomainID HexUInt32 A ID de domínio deste roteador de dispositivo. TopologyID UInt8FixedArray(7) A ID da topologia de 7 bytes desse roteador de dispositivo. AdapterNumber UInt8 O registro "Número do Adaptador" do espaço de configuração do adaptador ADP_CS_3. AdapterType HexUInt32 Registro de espaço de configuração do adaptador ADP_CS_2[23..0]. Ele combina os valores de "Adapter Type Protocol", "Adapter Type Version" e "Adapter Type Sub-Type".
Referência de especificação: "Tabela 8-9. Atributos básicos do espaço de configuração do adaptador" e "Tabela 8-10. Tipos de adaptador"Evento InterDomainPeerInformation
Propriedade Tipo de valor Descrição IsRundownEvent Booliano True se for um evento de resumo. DomainID HexUInt32 A ID de domínio deste roteador de dispositivo. TopologyID UInt8FixedArray(7) A ID da topologia de 7 bytes desse roteador de dispositivo. Lane0AdapterNumber UInt8 O número do adaptador da faixa 0 da porta local. O mesmo que Lane0AdapterNumber do evento "PortInformation".
Ele pode ser usado junto com as propriedades "DomainID" e "TopologyID" acima para localizar o evento "PortInformation" correspondente.LocalDomainUUID GUID O UUID de domínio do domínio local em uma conexão entre domínios. RemoteDomainUUID GUID O UUID de domínio do domínio remoto em uma conexão entre domínios. LocalRouteString UInt8FixedArray(7) A cadeia de caracteres de rota para a porta local. Ele está no formato de ID de topologia 7-UINT8. RemoteRouteString UInt8FixedArray(7) A cadeia de caracteres de rota para a porta remota. Ele está no formato de ID de topologia 7-UINT8 MaxHopID UInt16 A propriedade "MaxHopID" do bloco de propriedades entre domínios retornado pelo par remoto. Event DeviceRouterRemoval
Propriedade Tipo de valor Descrição DomainID HexUInt32 A ID de domínio do roteador do dispositivo. TopologyID UInt8FixedArray(7) A ID de topologia de 7 bytes do roteador do dispositivo.
Thunderbolt é uma marca registrada da Intel Corporation ou de suas subsidiárias.