OpenTraceFromRealTimeLoggerWithAllocationOptions 関数 (evntrace.h)

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

構文

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE 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_PROPERTIES の LogFileMode メンバーに EVENT_TRACE_REAL_TIME_MODE フラグを 含める設定 を行っている場合にのみ、イベントをリアルタイム で 使用できます。

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

Options

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

AllocationSize

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

MemoryPartitionHandle

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

LogFileHeader

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

戻り値

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

注釈

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

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	evntrace.h
Library	Windows 8.1 および Windows Server 2012 R2 の Sechost.lib;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista、Windows XP 上の Advapi32.lib
[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