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 を使用し、 バッファーを ネットワーク経由でローカル システムに送信した後、ローカル システムは OpenTraceFromBufferStream と ProcessTrace を呼び出し、ネットワークからバッファーを受信し、 ProcessTraceAddBufferToBufferStream を使用してローカル トレース プロセッサにフィードします。

この処理モードでは、 バッファーを ProcessTrace から受信したのと同じ順序でバッファーを指定する必要があります (たとえば、最初のバッファーにはヘッダー情報が含まれており、後続のバッファーはフラッシュ時間順に並べられます)。 この方法でバッファーを生成する唯一の方法は、別の OpenTraceFromBufferStream、OpenTraceFromFile、OpenTraceFromRealTimeLogger、OpenTraceFromRealTimeLoggerWithAllocationOptions 処理セッションからの BufferCallback からです。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	evntrace.h
Library	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