PEVENT_TRACE_BUFFER_CALLBACKA回呼函式 (evntrace.h)

  • 發行項

ETW 事件取用者會實作此函式，以接收 ETW 在追蹤處理會話期間傳遞之每個事件緩衝區的統計資料。 ETW 會在傳遞每個緩衝區的事件之後呼叫此函式。

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

語法

PEVENT_TRACE_BUFFER_CALLBACKA PeventTraceBufferCallbacka;

ULONG PeventTraceBufferCallbacka(
  PEVENT_TRACE_LOGFILEA 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 evntrace.h

另請參閱

EVENT_TRACE_LOGFILE

OpenTrace

ProcessTrace