PEVENT_TRACE_BUFFER_CALLBACKW回呼函式 (evntrace.h)

ETW 事件取用者會實作此函式，以接收 ETW 在追蹤處理工作階段期間所傳遞之每個事件緩衝區的相關統計數據。 ETW 會在傳遞每個緩衝區的事件之後呼叫此函式。

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

語法

PEVENT_TRACE_BUFFER_CALLBACKW PeventTraceBufferCallbackw;

ULONG PeventTraceBufferCallbackw(
  PEVENT_TRACE_LOGFILEW Logfile
)
{...}

參數

Logfile

包含緩衝區相關信息 之EVENT_TRACE_LOGFILE 結構的指標。

傳回值

若要繼續處理事件，請傳回 TRUE。 否則，傳回 FALSE。 傳回 FALSE 將會終止 ProcessTrace 函 式。

備註

若要指定 ETW 呼叫以傳遞緩衝區統計數據的函式，請設定您傳遞至 OpenTrace 函式之EVENT_TRACE_LOGFILE結構的 BufferCallback 成員。

範例

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

注意

evntrace.h 標頭會將PEVENT_TRACE_BUFFER_CALLBACK定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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

另請參閱

EVENT_TRACE_LOGFILE

OpenTrace

ProcessTrace