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 이벤트에 대해 설명합니다.
이벤트 RundownStart 및 RundownComplete는 런다운 이벤트의 시작과 끝을 나타내는 마커 이벤트입니다. 이벤트 속성이나 페이로드를 포함하지 않습니다.
이벤트 DeviceRouterInformation
속성 값 형식 Description 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 Product ID AsciiVendorName 문자열 ASCII의 공급업체 이름입니다. USB4 DROM 사양의 ASCII 공급업체 이름 항목 챕터에 정의되어 있습니다. AsciiModelName 문자열 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 디바이스 펌웨어 버전입니다. 이벤트 PortInformation
속성 값 형식 Description 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입니다. 다운스트림에 연결된 디바이스 라우터가 없으면 모두 0입니다. 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] "LCL(Link CLx Support)"의 값입니다. Tbt3CompatibleMode Boolean 포트 기능 레지스터 PORT_CS_18[9] "TCM(TBT3 호환 모드)"의 값입니다. 이벤트 PCIeAdapterInformation
속성 값 형식 Description 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입니다. 이벤트 DPAdapterInformation
속성 값 형식 Description 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] "최대 링크 수"의 값입니다. 이벤트 USB3AdapterInformation
속성 값 형식 Description 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] "실제 링크 속도"의 값입니다. 이벤트 OtherAdapterInformation
속성 값 형식 Description 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. 어댑터 유형"이벤트 InterDomainPeerInformation
속성 값 형식 Description 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" 속성입니다. 이벤트 DeviceRouterRemoval
속성 값 형식 Description DomainID HexUInt32 디바이스 라우터의 도메인 ID입니다. TopologyID UInt8FixedArray(7) 디바이스 라우터의 7바이트 토폴로지 ID입니다.
Thunderbolt는 Intel Corporation 또는 그 자회사의 상표입니다.