PEVENT_CALLBACK回呼函式 (evntrace.h)

發行項
02/29/2024

ETW 事件取用者會實作此回呼，以接收來自追蹤處理會話的事件。這個回呼不應該用於新的程式碼中。請改為實作 EventRecordCallback。

PEVENT_CALLBACK類型是這個回呼函式的指標。 EventCallback 是應用程式定義函數名稱的佔位元。

語法

PEVENT_CALLBACK PeventCallback;

void PeventCallback(
  [in] PEVENT_TRACE pEvent
)
{...}

參數

[in] pEvent

包含事件資訊的 EVENT_TRACE 結構的指標。

傳回值

無

備註

注意

此回呼已過時，因為它收到事件不完整的資訊，而且與 TdhGetEventInformation 之類的事件譯碼協助程式 API 不相容。而不是實作 EventCallback，請實作 EventRecordCallback。

若要指定 ETW 呼叫傳遞事件的函式，請設定傳遞至 OpenTrace 函式之EVENT_TRACE_LOGFILE結構的 EventCallback 成員。

注意

如果您的 EventCallback 函式收到來自 ProcessTrace 的 garbled 數據，請仔細檢查提供給 OpenTrace 之結構字段中EVENT_TRACE_LOGFILE所指定的ProcessTraceMode旗標。 EVENT_TRACE_LOGFILE的 EventCallback 和 EventRecordCallback 欄位是等位的重疊成員。 ProcessTraceMode如果欄位包含 PROCESS_TRACE_MODE_EVENT_RECORD 旗標，ProcessTrace 會使用 EventRecordCallback 函式簽章叫用回呼。否則 ，ProcessTrace 會使用 EventCallback 函式簽章叫用回呼。

使用 OpenTrace 建立追蹤處理工作階段之後，請呼叫 ProcessTrace 函式以開始接收事件。

當 ProcessTrace 開始處理追蹤的事件時，它可能會使用一或多個包含追蹤 (元數據的相關綜合事件) 來叫用回呼，而不是來自記錄事件的數據。這些綜合事件會根據綜合事件的內容，將 Header.Guid 設定為 EventTraceGuid 和 Header.Class.Type 集合。例如，每個追蹤檔案中的第一個事件會是包含 TRACE_LOGFILE_HEADER 資訊類型 0 的綜合事件。

您收到的所有其他事件都包含提供者特定的事件數據。您可以使用 EVENT_TRACE 的 Header.Guid 和 Header.Class.Type 成員來判斷您收到的事件類型。可以硬式編碼已知事件類型的譯碼邏輯，但大部分事件都會使用命名空間中登錄系統上的 \\root\wmi MOF架構信息來譯碼。如需使用事件的MOF架構來解譯事件的相關信息，請參閱取用事件。

範例

如需 EventCallback 函式的範例實作，請參閱使用 MOF 擷取事件數據。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	evntrace.h