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	此裝置路由器的網域識別碼。
   TopologyID	UInt8FixedArray (7)	此裝置路由器的 7 位元組拓撲識別碼。
   DeviceInstancePath	WideString	裝置路由器的 PnP 指派裝置實例路徑。 它可用來比對整合裝置屬性模型中PnP API 傳回的DEVPKEY_Device_InstanceId屬性資料。
   VendorId	HexUInt16	廠商識別碼
   ProductId	HexUInt16	Product ID
   AsciiVendorName	String	ASCII 中的廠商名稱。 它定義于 USB4 DROM 規格的 ASCII 廠商名稱專案一章中。
   AsciiModelName	String	ASCII 中的模型名稱。 它定義于 USB4 DROM 規格的 ASCII 模型名稱專案一章中。
   DeviceID	HexUInt16	若為[變更™ 3]，其為 [變更™ 3 標頭] 區段中的 「VendorId」 欄位。 針對 USB4，它是產品描述元專案中的 「idVendor」 欄位。
   ModelID	HexUInt16	針對 [雷氣™ 3] 區段中，它是 [系統™識別碼] 區段中的 [模型識別碼] 欄位。 針對 USB4，它是產品描述元專案中的 「idProduct」 欄位。
   UUID	HexUInt64	裝置 UUID。 針對 USB4，它是ROUTER_CS_7中的 UUID，而ROUTER_CS_8 USB4 規格所定義的暫存器。
   DeviceFirmwareVersion	HexUInt32	裝置韌體版本。

3. 事件 PortInformation

   屬性	值類型	描述
   IsRundownEvent	Boolean	如果它是取消事件，則為 True。 如果報告新的裝置路由器，則為 False。
   IsNewDeviceRouter	Boolean	如果報告新裝置路由器的埠，則為 True。 如果報告埠狀態變更，則為 False。 針對取消事件，它也為 false。
   DomainID	HexUInt32	此裝置路由器的網域識別碼。
   TopologyID	UInt8FixedArray (7)	此裝置路由器的 7 位元組拓撲識別碼。
   IsDFP	Boolean	如果相關聯的埠為 DFP，則為 True。 如果為 UFP，則為 False。
   Lane0AdapterNumber	UInt8	配接器組態空間暫存器的「配接器號碼」ADP_CS_3。
   Lane1AdapterNumber	UInt8	配接器組態空間暫存器的「配接器號碼」ADP_CS_3。
   DownstreamRouterDomainID	HexUInt32	下游裝置路由器的網域識別碼。
   DownstreamRouterTopologyID	UInt8FixedArray (7)	下游裝置路由器的 7 位元組拓撲識別碼。 如果沒有裝置路由器連線到下游，則所有零。
   SupportedLinkSpeeds	HexUInt8	來自 lane 配接器組態功能的值會登錄 LANE_ADP_CS_0[19..16] 「支援的連結速度」。
   SupportedLinkWidths	HexUInt8	來自 lane 配接器組態功能的值會登錄 LANE_ADP_CS_0[25..20] 「Supported Link Widths」。
   CurrentLinkSpeed	HexUInt8	來自 lane 配接器組態功能的值會登錄LANE_ADP_CS_1[19..16] 「Current Link Speed」。
   NegotiatedLinkWidth	HexUInt8	來自 lane 配接器組態功能的值會註冊LANE_ADP_CS_1[25..20] 「交涉的連結寬度」。
   TargetLinkSpeed	HexUInt8	來自 lane 配接器組態功能的值會註冊LANE_ADP_CS_1[3..0] 「Target Link Speed」。
   TargetLinkWidth	HexUInt8	來自 lane 配接器組態功能的值會註冊LANE_ADP_CS_1[9..4] 「Target Link Width」。
   AdapterState	HexUInt8	來自 lane 配接器組態功能的值會登錄LANE_ADP_CS_1[29..26] 「Adapter State」。
   LaneBonded	Boolean	指出此埠的通道是否已系結。
   CableUsbVersion	Boolean	埠功能的值會登錄PORT_CS_18[7..0] 「Cable USB Version」。
   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	此裝置路由器的網域識別碼。
   TopologyID	UInt8FixedArray (7)	此裝置路由器的 7 位元組拓撲識別碼。
   AdapterNumber	Uint8	配接器組態空間暫存器的「配接器號碼」ADP_CS_3。
   AdapterType	HexUInt32	配接器組態空間暫存器ADP_CS_2[23..0]。 它會結合 「配接器類型通訊協定」、「配接器類型版本」和「配接器類型子類型」的值。 規格參考：「表 8-9。 配接器組態空間基本屬性和 「Table 8-10。 配接器類型」
   IsDownstream	Boolean	如果它是下游 PCIe 配接器，則為 True。 如果它是上游，則為 False。
   IsTunneled	Boolean	True 是表示 如果通訊協定流量是通道的。

5. Event DPAdapterInformation

   屬性	值類型	描述
   IsRundownEvent	Boolean	如果它是取消事件，則為 True。 如果報告新的裝置路由器，則為 False。
   IsNewDeviceRouter	Boolean	如果報告新裝置路由器的埠，則為 True。 如果報告埠狀態變更，則為 False。 針對取消事件，它也為 false。
   DomainID	HexUInt32	此裝置路由器的網域識別碼。
   TopologyID	Uint8FixedArray (7)	此裝置路由器的 7 位元組拓撲識別碼。
   AdapterNumber	Uint8	配接器組態空間暫存器的「配接器號碼」ADP_CS_3。
   AdapterType	HexUInt32	配接器組態空間暫存器ADP_CS_2[23..0]。 它會結合 「配接器類型通訊協定」、「配接器類型版本」和「配接器類型子類型」的值。 規格參考：「表 8-9。 配接器組態空間基本屬性和 「Table 8-10。 配接器類型」
   IsDPOut	Boolean	如果它是 DP Out 配接器，則為 True。 如果它是 DP In，則為 False。
   IsTunneled	Boolean	True 是表示 如果通訊協定流量是通道的。
   MaximalLinkRate	HexUInt8	DP 配接器設定空間暫存器的值DP_COMMON_CAP[11..8] 「Maximal Link Rate」。
   MaximalLinkCount	HexUInt8	DP 配接器設定空間暫存器的值DP_COMMON_CAP[14..12] 「Maximal Link Count」。

6. 事件 USB3AdapterInformation

   屬性	值類型	描述
   IsRundownEvent	Boolean	如果它是取消事件，則為 True。 如果報告新的裝置路由器，則為 False。
   IsNewDeviceRouter	Boolean	如果報告新裝置路由器的埠，則為 True。 如果報告埠狀態變更，則為 False。 針對取消事件，它也為 false。
   DomainID	HexUInt32	此裝置路由器的網域識別碼。
   TopologyID	UInt8FixedArray (7)	此裝置路由器的 7 位元組拓撲識別碼。
   AdapterNumber	UInt8	配接器組態空間暫存器的「配接器號碼」ADP_CS_3。
   AdapterType	HexUInt32	配接器組態空間暫存器ADP_CS_2[23..0]。 它會結合 「配接器類型通訊協定」、「配接器類型版本」和「配接器類型子類型」的值。 規格參考：「表 8-9。 配接器組態空間基本屬性和 「Table 8-10。 配接器類型」
   IsDownstream	Boolean	如果它是下游 USB 3.x 配接器，則為 True。 如果它是上游，則為 False。
   IsTunneled	Boolean	True 是表示 如果通訊協定流量是通道的。
   ActualLinkRate	HexUInt8	USB 3.x 配接器組態空間中的值ADP_USB3_CS_4[6..0] 「Actual Link Rate」。

7. Event OtherAdapterInformation

   屬性	值類型	描述
   IsRundownEvent	Boolean	如果它是取消事件，則為 True。 如果報告新的裝置路由器，則為 False。
   IsNewDeviceRouter	Boolean	如果報告新裝置路由器的埠，則為 True。 如果報告埠狀態變更，則為 False。 針對取消事件，它也為 false。
   DomainID	HexUInt32	此裝置路由器的網域識別碼。
   TopologyID	UInt8FixedArray (7)	此裝置路由器的 7 位元組拓撲識別碼。
   AdapterNumber	UInt8	配接器組態空間暫存器的「配接器號碼」ADP_CS_3。
   AdapterType	HexUInt32	配接器組態空間暫存器ADP_CS_2[23..0]。 它會結合 「配接器類型通訊協定」、「配接器類型版本」和「配接器類型子類型」的值。 規格參考：「表 8-9。 配接器組態空間基本屬性和 「Table 8-10。 配接器類型」

8. 事件 InterDomainPeerInformation

   屬性	值類型	描述
   IsRundownEvent	Boolean	如果它是取消事件，則為 True。
   DomainID	HexUInt32	此裝置路由器的網域識別碼。
   TopologyID	UInt8FixedArray (7)	此裝置路由器的 7 位元組拓撲識別碼。
   Lane0AdapterNumber	UInt8	本機埠的 lane 0 配接器號碼。 與 「PortInformation」 事件的 Lane0AdapterNumber 相同。 它可與上述的 「DomainID」 和 「TopologyID」 屬性搭配使用，以尋找相符的 「PortInformation」 事件。
   LocalDomainUUID	GUID	網域間連線中本機網域的 UUID。
   RemoteDomainUUID	GUID	網域間連線中遠端網域的 UUID。
   LocalRouteString	UInt8FixedArray (7)	本機埠的路由字串。 它是 7-UINT8 拓撲識別碼格式。
   RemoteRouteString	UInt8FixedArray (7)	遠端埠的路由字串。 它是 7-UINT8 拓撲識別碼格式
   MaxHopID	UInt16	來自遠端對等傳回之網域間屬性區塊的 「MaxHopID」 屬性。

9. 事件 DeviceRouterRemoval

   屬性	值類型	描述
   DomainID	HexUInt32	裝置路由器的網域識別碼。
   TopologyID	UInt8FixedArray (7)	裝置路由器的 7 位元組拓撲識別碼。

Underbolt 是 Intel Corporation 或其子公司的商標。