Share via

TRACE_QUERY_INFO_CLASS 枚举 (evntrace.h)

  • 项目

与 EnumerateTraceGuidsEx、 TraceQueryInformation 或 TraceSetInformation 一起使用，以指定跟踪信息的类型。

请注意， TRACE_INFO_CLASS 和 TRACE_QUERY_INFO_CLASS 是同一枚举的 typedef。

有关枚举中的值应与哪些 API 一起使用以及相应的缓冲区输入和输出格式的更全面的文档在 中的evntrace.h枚举定义中TRACE_QUERY_INFO_CLASS内联提供。

语法

typedef enum _TRACE_QUERY_INFO_CLASS {
  TraceGuidQueryList = 0,
  TraceGuidQueryInfo = 1,
  TraceGuidQueryProcess = 2,
  TraceStackTracingInfo = 3,
  TraceSystemTraceEnableFlagsInfo = 4,
  TraceSampledProfileIntervalInfo = 5,
  TraceProfileSourceConfigInfo = 6,
  TraceProfileSourceListInfo = 7,
  TracePmcEventListInfo = 8,
  TracePmcCounterListInfo = 9,
  TraceSetDisallowList = 10,
  TraceVersionInfo = 11,
  TraceGroupQueryList = 12,
  TraceGroupQueryInfo = 13,
  TraceDisallowListQuery = 14,
  TraceInfoReserved15,
  TracePeriodicCaptureStateListInfo = 16,
  TracePeriodicCaptureStateInfo = 17,
  TraceProviderBinaryTracking = 18,
  TraceMaxLoggersQuery = 19,
  TraceLbrConfigurationInfo = 20,
  TraceLbrEventListInfo = 21,
  TraceMaxPmcCounterQuery = 22,
  TraceStreamCount = 23,
  TraceStackCachingInfo = 24,
  TracePmcCounterOwners = 25,
  TraceUnifiedStackCachingInfo = 26,
  TracePmcSessionInformation = 27,
  MaxTraceSetInfoClass = 28
} TRACE_QUERY_INFO_CLASS, TRACE_INFO_CLASS;

常量

 
TraceGuidQueryList
值： 0
查询在 上注册的提供程序的 GUID 数组
计算机。
TraceGuidQueryInfo
值：1
查询每个会话用于启用提供程序的信息。
TraceGuidQueryProcess
值： 2
查询在 中自行注册的提供程序的 GUID 数组
与调用进程相同的进程。
TraceStackTracingInfo
值： 3
查询内核事件的调用堆栈跟踪设置。

返回CLASSIC_EVENT_ID数组
结构。 结构指定堆栈跟踪所针对的事件 GUID
已启用。 数组限制为 256 个元素。

Windows 7、Windows Server 2008 R2 及更高版本支持该值。
TraceSystemTraceEnableFlagsInfo
值： 4
查询系统跟踪提供程序的 EnableFlags 设置。 For
有关详细信息，请参阅
EVENT_TRACE_PROPERTIES 结构。

Windows 8、Windows Server 2012 及更高版本支持该值。
TraceSampledProfileIntervalInfo
值： 5
查询提供的源的采样配置文件间隔设置。

Windows 8、Windows Server 2012 及更高版本支持该值。
TraceProfileSourceConfigInfo
值： 6
配置将在
性能监视计数器配置文件事件触发。 收集的计数器将
作为事件的一部分 PERF_PMC_PROFILE 发出。

Windows 8、Windows Server 2012 及更高版本支持该值。
TraceProfileSourceListInfo
值： 7
查询系统上可用的分析源列表。

Windows 8、Windows Server 2012 及更高版本支持该值。
TracePmcEventListInfo
值： 8
使用性能的系统事件列表配置会话
将收集由 TracePmcCounterListInfo 配置的监视计数器。

Windows 8、Windows Server 2012 及更高版本支持该值。
TracePmcCounterListInfo
值： 9
使用将收集的分析源列表配置会话
将 配置 TracePmcEventListInfo 的事件记录到会话时。

Windows 8、Windows Server 2012 及更高版本支持该值。
TraceSetDisallowList
值： 10
将未启用的提供程序列表设置为此会话的一部分
提供程序组启用。 有关详细信息，请参阅
提供程序特征。

Windows 10、Windows Server 2016 及更高版本支持该值。
TraceVersionInfo
值： 11
查询跟踪文件版本信息。

Windows 10、Windows Server 2016 及更高版本支持该值。
TraceGroupQueryList
值： 12
查询计算机上处于活动状态的提供程序组的 GUID 数组。
TraceGroupQueryInfo
值： 13
Windows 10、Windows Server 2016 及更高版本支持该值。

每个会话用于启用提供程序组的查询信息。
TraceDisallowListQuery
值： 14
Windows 10、Windows Server 2016 及更高版本支持该值。

查询此会话上不允许组启用的 GUID 数组。

Windows 10、Windows Server 2016 及更高版本支持该值。
TraceInfoReserved15
保留供将来使用。 请勿使用。
TracePeriodicCaptureStateListInfo
值： 16
汇报会话，其中包含将定期接收 的提供程序列表
EVENT_CONTROL_CODE_CAPTURE_STATE 控制代码，类似于来自 的调用
EnableTraceEx2。

有关详细信息，请参阅
TRACE_PERIODIC_CAPTURE_STATE_INFO。

Windows 10版本 1709、Windows Server 版本支持该值
1709 及更高版本。
TracePeriodicCaptureStateInfo
值： 17
查询系统上定期捕获状态设置的限制，包括
可以是 的最小时间频率和最大提供程序数
同时配置。

有关详细信息，请参阅
TRACE_PERIODIC_CAPTURE_STATE_INFO。

Windows 10版本 1709、Windows Server 版本支持该值
1709 及更高版本。
TraceProviderBinaryTracking
值： 18
指示 ETW 开始跟踪启用的所有提供程序的二进制文件
会话。 跟踪适用于对会话启用的提供程序
调用时，以及启用的所有未来提供程序
会话。

ETW 生成包含提供程序 GUID () 之间的映射的跟踪事件
以及包含跟踪提供程序的回调的模块的路径。 在
对于实时会话，实时提供实时事件
缓冲区。 在基于文件的会话中， (即，是否将跟踪保存到
.etl file) ，事件聚合并写入文件头;他们将
是 ETW 运行时在播放 .etl 文件时提供的第一批事件之一
返回。

二进制跟踪事件将具有提供程序 ID EventTraceGuid 和操作码
0x43.

Windows 10版本 1709、Windows Server 版本支持该值
1709 及更高版本。
TraceMaxLoggersQuery
值： 19
查询当前配置的最大 ETW 日志记录会话数
按操作系统。 返回 ULONG。 与以下步骤配合使用：
EnumerateTraceGuidsEx。

Windows 10版本 1709、Windows Server 版本支持该值
1709 及更高版本。
TraceLbrConfigurationInfo
值： 20
为给定会话启用最后一个分支记录跟踪，并配置
相应的 LBR 筛选器。

Windows 10版本 19H1、Windows Server 版本支持该值
1903 年及更高版本。
TraceLbrEventListInfo
值： 21
配置将触发 ETW 以跟踪上一个分支记录的事件列表
由 TraceLbrConfigurationInfo配置的信息。

Windows 10版本 19H1、Windows Server 版本支持该值
1903 年及更高版本。
TraceMaxPmcCounterQuery
值： 22
查询可能同时的最大分析源数
配置为与 ETW 一起使用。

Windows 10版本 19H1、Windows Server 版本支持该值
1903 年及更高版本。
TraceStreamCount
值： 23
查询会话的已配置流计数。 这通常是，但不是
始终，等于系统上的处理器数;如果没有，则为 1
为会话配置了每处理器缓冲。

Windows 10版本 21H2、Windows Server 2022 和
稍后。
TraceStackCachingInfo
值： 24
指示 ETW 开始缓存基于 RegisterTraceGuids 的堆栈跟踪
(“Classic”) 此会话中的事件。

Windows 10版本 21H2、Windows Server 2022 和
稍后。
TracePmcCounterOwners
值： 25
在 ETW 中查询当前中的处理器性能监视计数器列表
使用。 此列表可能包含 ETW 以外的其他设施使用的计数器。

Windows 10版本 21H2、Windows Server 2022 和
稍后。
TraceUnifiedStackCachingInfo
值： 26
指示 ETW 开始缓存两个基于 RegisterTraceGuids 的堆栈跟踪
(“Classic”) 和基于 EventRegister 的事件。

Windows 10版本 21H2、Windows Server 2022 和
稍后。
TracePmcSessionInformation
值： 27
通过 TracePmcEventListInfo 和 TracePmcCounterListInfo查询所有会话以查找其 PMC 配置集。

Windows 10 版本 22H2 及更高版本支持该值。
MaxTraceSetInfoClass
值： 28
标记枚举中的最后一个值。 请勿使用。

备注

TRACE_INFO_CLASS 和 TRACE_QUERY_INFO_CLASS 枚举都定义相同的值。 将这两个枚举与 EnumerateTraceGuidsEx 函数或 TraceSetInformation 函数一起使用。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
标头 evntrace.h

请参阅

EnumerateTraceGuidsEx

TraceSetInformation