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

必要条件