次の方法で共有

OpenTraceFromRealTimeLoggerWithAllocationOptions 関数 (evntrace.h)

  • [アーティクル]

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

構文

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLoggerWithAllocationOptions(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  ULONG_PTR                    AllocationSize,
  HANDLE                       MemoryPartitionHandle,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

パラメーター

LoggerName

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

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

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

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

Options

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

AllocationSize

処理中に ETW バッファーを格納するために事前に割り当てられるメモリのサイズ (バイト単位)。 割り当てが大きいほど、メモリ使用量の一貫性が高くなる代償として、個々の割り当て/空き呼び出しの必要性が軽減されます。 これは、基本的な機能のために十分に割り当てられるように、基になる Real-Time ETW セッションの合計バッファー領域の最小値に上向きに調整されます。 0 の場合、既定のサイズが使用されます。

MemoryPartitionHandle

この処理セッションのメモリ割り当てに使用する必要があるメモリ パーティションへのハンドル。 NULL の場合、プロセスのメモリ パーティションが使用されます。 詳細については、MemExtendedParameterPartitionHandle の を参照してください。

LogFileHeader

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

戻り値

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

備考

返 TRACEHANDLEで ProcessTrace が呼び出されると、フラッシュされると ETW セッションからバッファーが受信され、すぐに処理が開始され、[オプション] で指定されたコールバックが呼び出されます。 これは OpenTraceFromRealTime と同じですが、処理セッションのメモリ割り当てをカスタマイズできる点が異なります。

必要条件

要件 価値
サポートされる最小クライアント 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