OpenTraceW

OpenTraceW (Unicode) 関数 (evntrace.h) は、ETW リアルタイムトレースセッションまたは ETW ログファイルからイベントを取得するための ETW トレース処理ハンドルを開く。

OpenTraceW Logfile

Logfile : [var] [EVENT_TRACE_LOGFILE](/windows/win32/api/evntrace/ns-evntrace-event_trace_logfilew) 構造体へのポインタ。構造体は、イベントを取得するソース (ETW ログファイルまたはリアルタイム ETW セッション) を指定し、コンシューマがイベントを受け取るために使用するコールバックを指定する。成功時には **OpenTrace** は、開いたファイルまたはセッションからの情報で構造体を更新する。

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

解説

OpenTraceW (Unicode) 関数 (evntrace.h) は、ETW リアルタイムトレースセッションまたは ETW
ログファイルからイベントを取得するための ETW トレース処理ハンドルを開く。

[戻り値]
関数が成功した場合、トレース処理ハンドルを返す。ハンドルは
[CloseTrace](/windows/win32/api/evntrace/nf-evntrace-closetrace)
を使用して閉じる必要がある。関数が失敗した場合、**INVALID_PROCESSTRACE_HANDLE** を返す。
（以下省略）

[備考]
トレースコンシューマは、トレース処理セッションを開くためにこの関数を呼び出す。**OpenTrace**
を呼び出した後、[ProcessTrace](/windows/win32/api/evntrace/nf-evntrace-processtrace)
関数を呼び出してイベントを処理する。イベントの処理が完了したら、[CloseTrace](/windows/win32/api/evntrace/nf-evntrace-closetrace)
関数を呼び出してトレース処理ハンドルを閉じる。

情報