共用方式為

OpenTraceFromBufferStream 函式 （evntrace.h）

  • 發行項

建立未直接附加至任何檔案或使用中會話的追蹤處理會話。

語法

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromBufferStream(
  const ETW_OPEN_TRACE_OPTIONS    *Options,
  PETW_BUFFER_COMPLETION_CALLBACK BufferCompletionCallback,
  void                            *BufferCompletionContext
);

參數

Options

此處理工作階段的組態選項。 如需詳細資訊，請參閱 ETW_OPEN_TRACE_OPTIONS

BufferCompletionCallback

當處理會話使用從 ProcessTraceAddBufferToBufferStream傳入的緩衝區完成時，它會叫用此回呼，以允許該緩衝區可能需要的任何釋放或其他清除。

BufferCompletionContext

將傳遞至 BufferCompletionCallback的使用者提供內容。

傳回值

用來識別此處理會話的 TRACEHANDLE。 通常傳遞至 ProcessTrace，開始處理，並 CloseTrace 結束處理。

言論

呼叫端應該呼叫 ProcessTraceAddBufferToBufferStream來提供追蹤的數據。 這通常用於遠端即時追蹤處理：遠端系統會使用 OpenTraceFromRealTimeLogger 和 ProcessTrace 搭配 BufferCallback，透過網路將緩衝區傳送至本機系統， 然後，本機系統會呼叫 OpenTraceFromBufferStream 和 ProcessTrace，從網路接收緩衝區，並使用 ProcessTraceAddBufferToBufferStream將它們饋送至本機追蹤處理器。

此處理模式要求緩衝區的順序與從 processTrace 接收緩衝區的順序相同（例如，第一個緩衝區包含標頭資訊，後續的緩衝區會依排清時間排序）。 以這種方式產生緩衝區的唯一支援方式是從另一個 OpenTraceFromBufferStreamOpenTraceFromCallback File、OpenTraceFromRealTimeLogger、OpenTraceFromRealTimeLoggerWithAllocationOptions 處理會話。

要求

要求 價值
最低支援的用戶端 Windows 11 2022 Update
支援的最低伺服器 Windows Server 2022
目標平臺 窗戶
標頭 evntrace.h
連結庫 Advapi32.dll
DLL Sechost.dll Windows 8.1 和 Windows Server 2012 R2;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.dll