OpenTraceFromRealTimeLogger 関数 (evntrace.h)

アクティブなリアルタイム ETW セッションにアタッチされたトレース処理セッションを作成します。

構文

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

パラメーター

LoggerName

リアルタイム イベント トレース セッションの名前。ログ ファイルからデータを処理する場合は NULL 。 OpenTraceFromRealTimeLogger 呼び出してリアルタイム セッションからデータを使用する場合は、このメンバーの値を指定します。

OpenTraceFromRealTimeLoggerを呼び出すときに、LogFileHeader が nullでない場合は、LoggerName NULLする必要があります。

トレース コントローラーが EVENT_TRACE_REAL_TIME_MODE フラグを含むように EVENT_TRACE_PROPERTIES の LogFileMode メンバーを設定している場合にのみ、イベントをリアルタイムで使用できます。

管理特権を持つユーザー、パフォーマンス ログ ユーザー グループ内のユーザー、LocalSystem、LocalService、NetworkService として実行されているアプリケーションのみが、リアルタイムでイベントを使用できます。 制限付きユーザーにリアルタイムでイベントを使用する権限を付与するには、イベントをパフォーマンス ログ ユーザー グループに追加するか、EventAccessControl呼び出します。

Options

この処理セッションの構成オプション。 詳細については、ETW_OPEN_TRACE_OPTIONS を参照してください。

LogFileHeader

ログ ファイルのヘッダー情報。 詳細については、TRACE_LOGFILE_HEADER を参照してください。

戻り値

この処理セッションを識別するために使用される TRACEHANDLE。 通常、処理を開始し、CloseTrace を終了処理に するために、ProcessTrace に渡されます。

備考

返 TRACEHANDLEで ProcessTrace が呼び出されると、フラッシュされると ETW セッションからバッファーが受信され、すぐに処理が開始され、オプションで指定されたコールバックが呼び出されます。

必要条件

要件	価値
サポートされる最小クライアント	Windows 11 2022 Update
サポートされる最小サーバー	Windows Server 2022
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	evntrace.h
ライブラリ	Advapi32.dll
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