evntrace.h 標頭

此標頭由多個技術使用。 如需詳細資訊，請參閱

• 事件追蹤
• 核心模式驅動程式參考

evntrace.h 包含下列程式設計介面：

函式

CloseTrace CloseTrace 函式會關閉使用 OpenTrace 建立的追蹤處理會話。
ControlTraceA ControlTraceA (ANSI) 函式 (evntrace.h) 排清、查詢、更新或停止指定的事件追蹤會話。
ControlTraceW ControlTraceW (Unicode) 函式 (evntrace.h) 排清、查詢、更新或停止指定的事件追蹤會話。
CreateTraceInstanceId RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 CreateTraceInstanceId 函式來建立唯一的交易識別碼，並將其對應至註冊控制碼。 接著，提供者可以在呼叫 TraceEventInstance 函式時使用交易識別碼。
EnableTrace 追蹤會話控制器會呼叫 EnableTrace，以設定 ETW 事件提供者如何將事件記錄到追蹤會話。 EnableTraceEx2 函式會取代此函式。
EnableTraceEx 追蹤會話控制器會呼叫 EnableTraceEx，以設定 ETW 事件提供者如何將事件記錄到追蹤會話。 EnableTraceEx2 函式會取代此函式。
EnableTraceEx2 追蹤會話控制器會呼叫 EnableTraceEx2，以設定 ETW 事件提供者如何將事件記錄到追蹤會話。
EnumerateTraceGuids 擷取目前在電腦上執行之事件追蹤提供者的相關資訊。 EnumerateTraceGuidsEx 函式會取代此函式。
EnumerateTraceGuidsEx 擷取目前在電腦上執行之事件追蹤提供者的相關資訊。
FlushTraceA FlushTraceA (ANSI) 函式 (evntrace.h) 會導致事件追蹤會話立即傳遞指定會話的緩衝事件。
FlushTraceW FlushTraceW (Unicode) 函式 (evntrace.h) 會導致事件追蹤會話立即傳遞指定會話的緩衝事件。
GetTraceEnableFlags RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 GetTraceEnableFlags 函式來擷取追蹤控制器所指定的啟用旗標，以指出要追蹤的事件類別。 提供者會從其 ControlCallback 函式呼叫此函式。
GetTraceEnableLevel RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 GetTraceEnableLevel 函式來擷取追蹤控制器所指定的啟用層級，以指出要追蹤的事件層級。 提供者會從其 ControlCallback 函式呼叫此函式。
GetTraceLoggerHandle RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 GetTraceLoggerHandle 函式來擷取它應該寫入事件的事件追蹤會話控制碼。 提供者會從其 ControlCallback 函式呼叫此函式。
OpenTraceA OpenTraceA (ANSI) 函式 (evntrace.h) 會開啟 ETW 追蹤處理控制碼，以取用來自 ETW 即時追蹤會話或 ETW 記錄檔的事件。
OpenTraceFromBufferStream 建立未直接附加至任何檔案或使用中會話的追蹤處理會話。
OpenTraceFromFile 建立追蹤處理會話以處理 Tracelog .etl 檔案。
OpenTraceFromRealTimeLogger 開啟 ETW 追蹤處理控制碼，以取用來自 ETW 即時追蹤會話或 ETW 記錄檔的事件。
OpenTraceFromRealTimeLoggerWithAllocationOptions 建立附加至作用中即時 ETW 會話的追蹤處理會話。
OpenTraceW OpenTraceW (Unicode) 函式 (evntrace.h) 會開啟 ETW 追蹤處理控制碼，以取用來自 ETW 即時追蹤會話或 ETW 記錄檔的事件。
ProcessTrace 將事件從一或多個追蹤處理會話傳遞至取用者。
ProcessTraceAddBufferToBufferStream 將 ETW 追蹤緩衝區提供給 OpenTraceFromBufferStream 所建立的處理會話。
ProcessTraceBufferDecrementReference 釋放 ProcessTraceBufferIncrementReference 所新增之 Buffer 的參考。
ProcessTraceBufferIncrementReference 在提供的 BufferCallback 期間呼叫，以防止在呼叫端完成呼叫者之前釋放它。
QueryAllTracesA QueryAllTracesA (ANSI) 函式 (evntrace.h) 函式會擷取呼叫端可查詢之所有事件追蹤會話的屬性和統計資料。
QueryAllTracesW QueryAllTracesW (Unicode) 函式 (evntrace.h) 函式會擷取呼叫端可查詢之所有事件追蹤會話的屬性和統計資料。
QueryTraceA QueryTraceA (ANSI) 函式 (evntrace.h) 會擷取指定事件追蹤會話的屬性設定和會話統計資料。
QueryTraceProcessingHandle 擷取 OpenTrace 所開啟之 ETW 追蹤處理會話的相關資訊。
QueryTraceW QueryTraceW (Unicode) 函式 (evntrace.h) 擷取指定事件追蹤會話的屬性設定和會話統計資料。
RegisterTraceGuidsA RegisterTraceGuidsA (ANSI) 函式 (evntrace.h) 是過時的函式，而且新的程式碼應該使用提供的替代方法。
RegisterTraceGuidsW RegisterTraceGuidsW (Unicode) 函式 (evntrace.h) 是過時的函式，而且新的程式碼應該使用提供的替代方法。
RemoveTraceCallback RemoveTraceCallback 函式會停止 EventCallback 函式接收事件追蹤類別的事件。 此函式已過時。
SetTraceCallback SetTraceCallback 函式會指定 EventCallback 函式來處理指定事件追蹤類別的事件。 此函式已過時。
StartTraceA StartTrace 函式會啟動事件追蹤會話。 (ANSI)
StartTraceW StartTrace 函式會啟動事件追蹤會話。 (Unicode)
StopTraceA StopTraceA (ANSI) 函式 (evntrace.h) 會停止指定的事件追蹤會話。 ControlTrace 函式會取代此函式。
StopTraceW StopTraceW (Unicode) 函式 (evntrace.h) 會停止指定的事件追蹤會話。 ControlTrace 函式會取代此函式。
TraceEvent RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 TraceEvent 函式，將結構化事件傳送至事件追蹤會話。
TraceEventInstance RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 TraceEventInstance 函式，將結構化事件傳送至具有實例識別碼的事件追蹤會話。
TraceMessage RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 TraceMessage 函式，將訊息型 (TMF 型 WPP) 事件傳送至事件追蹤會話。
TraceMessageVa RegisterTraceGuids 型 (「傳統」) 事件提供者會使用 TraceMessageVa 函式，使用 va_list 參數將訊息型 (TMF 型 WPP) 事件傳送至事件追蹤會話。
TraceQueryInformation 提供事件追蹤會話的相關資訊。
TraceSetInformation 設定事件追蹤會話設定。
UnregisterTraceGuids 取消註冊 Windows 2000 樣式 (的「傳統」) 使用 RegisterTraceGuids 註冊的 ETW 事件追蹤提供者。
UpdateTraceA UpdateTraceA (ANSI) 函式 (evntrace.h) 會更新指定事件追蹤會話的屬性設定。
UpdateTraceW UpdateTraceW (Unicode) 函式 (evntrace.h) 會更新指定事件追蹤會話的屬性設定。

回呼函式

PETW_BUFFER_CALLBACK ProcessTrace 將叫用之 BufferCallback 的函式定義。
PETW_BUFFER_COMPLETION_CALLBACK 當 ProcessTraceAddBufferToBufferStream 完成緩衝區時，將會引發回呼的函式定義。 此回呼通常應該適當地釋放緩衝區
PEVENT_CALLBACK ETW 事件取用者會實作此回呼，以接收來自追蹤處理會話的事件。 EventRecordCallback 回呼會取代此回呼。
PEVENT_RECORD_CALLBACK ETW 事件取用者會實作此回呼，以接收來自追蹤處理會話的事件。 PEVENT_RECORD_CALLBACK類型會定義這個回呼函式的指標。 EventRecordCallback 是應用程式定義函數名稱的預留位置。
PEVENT_TRACE_BUFFER_CALLBACKA PEVENT_TRACE_BUFFER_CALLBACKA (ANSI) (evntrace.h) 函式會取得 ETW 在追蹤處理會話期間傳送之每個事件緩衝區的統計資料。
PEVENT_TRACE_BUFFER_CALLBACKW PEVENT_TRACE_BUFFER_CALLBACKW (Unicode) (evntrace.h) 函式會取得 ETW 在追蹤處理會話期間傳送之每個事件緩衝區的統計資料。
WMIDPREQUEST RegisterTraceGuids 型 (「傳統」) 事件提供者會實作此函式，以接收來自控制器的通知。 WMIDPREQUEST 類型會定義這個回呼函式的指標。 ControlCallback 是應用程式定義函數名稱的預留位置。

結構

CLASSIC_EVENT_ID 識別您要啟用呼叫堆疊追蹤的核心事件。
ENABLE_TRACE_PARAMETERS 包含用來透過 EnableTraceEx2 啟用提供者的資訊。
ENABLE_TRACE_PARAMETERS_V1 包含用來透過 EnableTraceEx2 啟用提供者的資訊。 這個結構已經過時。
ETW_BUFFER_CALLBACK_INFORMATION 提供給 BufferCallback 作為 ConsumerInfo 參數，並提供目前處理會話的詳細資料。
ETW_BUFFER_CONTEXT 提供事件的內容資訊。
ETW_BUFFER_HEADER ETW 緩衝區的標頭結構。
ETW_OPEN_TRACE_OPTIONS 提供 OpenTraceFromBufferStream、OpenTraceFromFile、OpenTraceFromRealTimeLogger、OpenTraceFromRealTimeLoggerWithAllocationOptions 函式的組態參數。
ETW_TRACE_PARTITION_INFORMATION 包含從 ETW 追蹤提取的資料分割資訊。
EVENT_INSTANCE_HEADER EVENT_INSTANCE_HEADER 結構包含 TraceEventInstance 所撰寫之所有事件通用的標準事件追蹤資訊。
EVENT_INSTANCE_INFO EVENT_INSTANCE_INFO 結構會將唯一的交易識別碼對應至 TraceEventInstance 的已註冊事件追蹤類別。
EVENT_TRACE EVENT_TRACE 結構可用來將事件資訊傳遞至事件追蹤取用者。
EVENT_TRACE_HEADER EVENT_TRACE_HEADER 結構包含 TraceEvent 所撰寫之所有事件通用的標準事件追蹤資訊。
EVENT_TRACE_LOGFILEA EVENT_TRACE_LOGFILEA (ANSI) 結構 (evntrace.h) 會儲存追蹤資料來源的相關資訊。
EVENT_TRACE_LOGFILEW EVENT_TRACE_LOGFILEW (Unicode) 結構 (evntrace.h) 會儲存追蹤資料來源的相關資訊。
EVENT_TRACE_PROPERTIES EVENT_TRACE_PROPERTIES 結構包含事件追蹤會話的相關資訊，並搭配 StartTrace 和 ControlTrace 等 API 使用。
EVENT_TRACE_PROPERTIES_V2 EVENT_TRACE_PROPERTIES_V2 結構包含事件追蹤會話的相關資訊，並搭配 StartTrace 和 ControlTrace 等 API 使用。
MOF_FIELD 您可以使用MOF_FIELD結構，將事件資料附加至EVENT_TRACE_HEADER或EVENT_INSTANCE_HEADER結構。
TRACE_ENABLE_INFO 定義會話，以及用來啟用提供者的會話資訊。
TRACE_GUID_INFO EnumerateTraceGuidsEx 傳回。 定義啟用提供者之會話清單的標頭。
TRACE_GUID_PROPERTIES EnumerateTraceGuids 傳回。 包含事件追蹤提供者的相關資訊。
TRACE_GUID_REGISTRATION 與 RegisterTraceGuids 搭配使用，以註冊事件追蹤類別。
TRACE_LOGFILE_HEADER TRACE_LOGFILE_HEADER 結構包含事件追蹤會話及其事件的相關資訊。
TRACE_PERIODIC_CAPTURE_STATE_INFO 與 TraceQueryInformation 和 TraceSetInformation 搭配使用，以取得或設定與定期擷取狀態相關的資訊。
TRACE_PROVIDER_INSTANCE_INFO 定義提供者 GUID 的實例。
TRACE_VERSION_INFO 決定 TraceLogging 會話的版本資訊。

列舉

ETW_PROCESS_HANDLE_INFO_TYPE 指定將在追蹤處理會話上執行的作業。
ETW_PROCESS_TRACE_MODES 指定支援的進程追蹤模式。
TRACE_QUERY_INFO_CLASS 與 EnumerateTraceGuidsEx 和 TraceSetInformation 搭配使用，以指定追蹤資訊的類型。