TRACE_QUERY_INFO_CLASS列舉 (evntrace.h)

EnumerateTraceGuidsExTraceQueryInformationTraceSetInformation 搭配使用,以指定追蹤資訊的類型。

請注意, TRACE_INFO_CLASSTRACE_QUERY_INFO_CLASS 是相同列舉的 typedefs。

更完整的檔說明列舉中應搭配使用哪些 API,以及對應的緩衝區輸入和輸出格式,可在 中的 evntrace.h 列舉定義中 TRACE_QUERY_INFO_CLASS 內嵌使用。

Syntax

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 (s) 之間的對應
以及包含追蹤提供者回呼之模組的路徑。 位於
即時會話的情況是即時提供事件
緩衝區。 在檔案型會話的情況下, (亦即,如果追蹤儲存至 ,則為
.etl 檔案) ,事件會匯總並寫入檔頭;他們將會
當播放 .etl 檔案時,ETW 執行時間會提供的第一個事件
返回。

二進位追蹤事件會有提供者識別碼 EventTraceGuid 和 opcode
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 型的堆疊追蹤
在此會話中 (「傳統」) 事件。

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
透過 和 TracePmcCounterListInfo 查詢其 PMC 組態集 TracePmcEventListInfo 的所有會話。

Windows 10版本 22H2 和更新版本支援此值。
MaxTraceSetInfoClass
值: 28
標記列舉中的最後一個值。 請勿使用。

備註

TRACE_INFO_CLASSTRACE_QUERY_INFO_CLASS列舉都會定義相同的值。 使用這兩個列舉搭配 EnumerateTraceGuidsEx 函式或 TraceSetInformation 函式

需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 evntrace.h

另請參閱

EnumerateTraceGuidsEx

TraceSetInformation