OpenTraceFromBufferStream 函式 (evntrace.h)

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

語法

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE 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 (接收緩衝區的順序相同，例如，第一個緩衝區包含標頭資訊，後續緩衝區會依排清時間排序) 。 唯一支援以這種方式產生緩衝區的方法，是從另一個OpenTraceFromBufferStream、OpenTraceFromFile、OpenTraceFromRealTimeLogger、OpenTraceFromRealTimeLoggerWithAllocationOptions處理會話的BufferCallback產生緩衝區。

需求

最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	evntrace.h
程式庫	Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.lib;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.lib
Dll	Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.dll;windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.dll