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。 通常、処理を開始し、CloseTrace を終了処理に するために、ProcessTrace に渡されます。

備考

呼び出し元は、processTraceAddBufferToBufferStream呼び出すことによって、トレースのデータを提供することが期待されます。 これは通常、リモート リアルタイム トレース処理に使用されます。リモート システムでは、OpenTraceFromRealTimeLogger を使用し、ProcessTrace と、ネットワーク経由でローカル システムにバッファーを送信する BufferCallback を使用します。 その後、ローカル システムは OpenTraceFromBufferStream を呼び出し、ProcessTraceを し、ネットワークからバッファーを受信し、ProcessTraceAddBufferToBufferStreamを使用してローカル トレース プロセッサにフィードします。

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

必要条件