ProcessTrace

1 つ以上のトレース処理セッションからコンシューマにイベントを配信する。

ProcessTrace HandleArray, HandleCount, StartTime, EndTime

HandleArray : [var] 以前の [OpenTrace](/windows/win32/api/evntrace/nf-evntrace-opentracea) 関数の呼び出しで取得したトレース処理セッションハンドルの配列へのポインタ。配列には最大 64 個のファイル処理セッションハンドル、または 1 個のリアルタイム処理セッションハンドルを含めることができる。配列にファイル処理セッションハンドルとリアルタイム処理セッションハンドルの両方を含めることはできない。
HandleCount : [int] _HandleArray_ の要素数。
StartTime : [var] イベントを受け取る開始時刻を指定する任意の [FILETIME](/windows/win32/api/minwinbase/ns-minwinbase-filetime) 構造体へのポインタ。関数は _StartTime_ より前のタイムスタンプを持つイベントを配信しない。
EndTime : [var] イベントを受け取る終了時刻を指定する任意の [FILETIME](/windows/win32/api/minwinbase/ns-minwinbase-filetime) 構造体へのポインタ。関数は _EndTime_ 以降のタイムスタンプを持つイベントを配信しない。**Windows Server 2003:** この値はリアルタイムイベント配信では無視される。

(プラグイン / モジュール : advapi32.dll)

解説

1 つ以上のトレース処理セッションからコンシューマにイベントを配信する。

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS である。関数が失敗した場合、戻り値は [system error
codes](/windows/win32/debug/system-error-codes) のいずれかである。
（以下省略）

[備考]
トレースコンシューマは、1
つ以上のトレース処理セッションからイベントを処理するためにこの関数を呼び出す。この関数は処理が終了するまでブロックする。**ProcessTrace**
を呼び出す前に、[OpenTrace](/windows/win32/api/evntrace/nf-evntrace-opentracea)
を使用してトレース処理セッションへのハンドルを開く。**ProcessTrace** 関数は、コンシューマの
[BufferCallback](/windows/win32/api/evntrace/nc-evntrace-pevent_trace_buffer_callbacka)、[EventCallback](/windows/win32/api/evntrace/nc-evntrace-pevent_callback)、[EventRecordCallback](/windows/win32/api/evntrace/nc-evntrace-pevent_record_callback)
コールバック関数を呼び出すことで、セッションからのイベントを配信する。
（以下省略）

情報