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 取消註冊使用 RegisterTraceGuids 註冊的「傳統」 (Windows 2000 樣式) 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_CONTEXT_REGISTER_INFO 識別啟用內容快取器追蹤時要記錄的緩存器集合。 |
| 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_CONTEXT_REGISTER_TYPES 指定要在啟用內容快取器追蹤時收集的緩存器集合。 |
| ETW_PROCESS_HANDLE_INFO_TYPE 指定將在追蹤處理工作階段上執行的作業。 |
| ETW_PROCESS_TRACE_MODES 指定支援的進程追蹤模式。 |
| TRACE_QUERY_INFO_CLASS 與 EnumerateTraceGuidsEx 和 TraceSetInformation 搭配使用，以指定追蹤信息的類型。 |