TRACE_QUERY_INFO_CLASS 枚举 (evntrace.h)

EnumerateTraceGuidsExTraceQueryInformationTraceSetInformation 一起使用可指定跟踪信息的类型。

请注意, TRACE_INFO_CLASSTRACE_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,
  TraceContextRegisterInfo = 28,
  MaxTraceSetInfoClass = 29
} 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 文件) , 事件聚合并写入文件头;他们将
是 ETW 运行时在播放 .etl 文件时提供的第一个事件之一
返回。

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

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

值在 Windows 10 版本 1709、Windows Server 版本上受支持
1709 及更高版本。
TraceLbrConfigurationInfo
值: 20
为给定会话启用 Last Branch Record 跟踪,并配置
相应的 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 的堆栈跟踪
在此会话中 (“经典”) 事件。

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

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

Windows 10 版本 21H2、Windows Server 2022 和
稍后。
TracePmcSessionInformation
值: 27
通过 TracePmcEventListInfoTracePmcCounterListInfo查询其 PMC 配置集的所有会话。

Windows 10 版本 22H2 及更高版本支持该值。
TraceContextRegisterInfo
值: 28
使用为其注册上下文的系统事件列表配置会话
将收集事件。 上下文寄存器事件包含 CPU 寄存器
触发指定相关事件时的内容。

Windows Server 23H2 及更高版本支持该值。
MaxTraceSetInfoClass
值: 29
标记枚举中的最后一个值。 请勿使用。

注解

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

要求

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

另请参阅

EnumerateTraceGuidsEx

TraceSetInformation