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,
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 通过 TracePmcEventListInfo 和 TracePmcCounterListInfo 查询其 PMC 配置集的所有会话。Windows 10 版本 22H2 及更高版本支持该值。 |
TraceContextRegisterInfo 值: 28 使用为其注册上下文的系统事件列表配置会话 将收集事件。 上下文寄存器事件包含 CPU 寄存器 触发指定相关事件时的内容。 Windows Server 23H2 及更高版本支持该值。 |
MaxTraceSetInfoClass 值: 29 标记枚举中的最后一个值。 请勿使用。 |
注解
TRACE_INFO_CLASS和TRACE_QUERY_INFO_CLASS枚举都定义相同的值。 将这两个枚举与 EnumerateTraceGuidsEx 函数或 TraceSetInformation 函数一起使用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
标头 | evntrace.h |