evntrace.h ヘッダー

このヘッダーは、複数のテクノロジで使用されます。 詳細については、次を参照してください。

• イベント トレース
• カーネル モード ドライバー リファレンス

evntrace.h には、次のプログラミング インターフェイスが含まれています。

関数

CloseTrace CloseTrace 関数は、OpenTrace で作成されたトレース処理セッションを閉じます。
ControlTraceA ControlTraceA (ANSI) 関数 (evntrace.h) は、指定されたイベント トレース セッションをフラッシュ、クエリ、更新、または停止します。
ControlTraceW ControlTraceW (Unicode) 関数 (evntrace.h) は、指定されたイベント トレース セッションをフラッシュ、クエリ、更新、または停止します。
CreateTraceInstanceId RegisterTraceGuids ベース ("Classic") イベント プロバイダーは、CreateTraceInstanceId 関数を使用して一意のトランザクション識別子を作成し、登録ハンドルにマップします。 プロバイダーは、TraceEventInstance 関数を呼び出すときにトランザクション識別子を使用できます。
EnableTrace トレース セッション コントローラーは EnableTrace を呼び出して、ETW イベント プロバイダーがイベントをトレース セッションに記録する方法を構成します。 EnableTraceEx2 関数は、この関数よりも優先されます。
EnableTraceEx トレース セッション コントローラーは EnableTraceEx を呼び出して、ETW イベント プロバイダーがイベントをトレース セッションに記録する方法を構成します。 EnableTraceEx2 関数は、この関数よりも優先されます。
EnableTraceEx2 トレース セッション コントローラーは EnableTraceEx2 を呼び出して、ETW イベント プロバイダーがイベントをトレース セッションに記録する方法を構成します。
EnumerateTraceGuids コンピューターで現在実行されているイベント トレース プロバイダーに関する情報を取得します。 EnumerateTraceGuidsEx 関数は、この関数よりも優先されます。
EnumerateTraceGuidsEx コンピューターで現在実行されているイベント トレース プロバイダーに関する情報を取得します。
FlushTraceA FlushTraceA (ANSI) 関数 (evntrace.h) を使用すると、イベント トレース セッションは、指定したセッションのバッファーイベントを直ちに配信します。
FlushTraceW FlushTraceW (Unicode) 関数 (evntrace.h) を使用すると、イベント トレース セッションは、指定したセッションのバッファーイベントを直ちに配信します。
GetTraceEnableFlags RegisterTraceGuids ベース ("Classic") イベント プロバイダーは、GetTraceEnableFlags 関数を使用して、トレースするイベントのカテゴリを示すためにトレース コントローラーで指定された有効フラグを取得します。 プロバイダーは、ControlCallback 関数からこの関数を呼び出します。
GetTraceEnableLevel RegisterTraceGuids ベース ("Classic") イベント プロバイダーは、GetTraceEnableLevel 関数を使用して、トレース コントローラーで指定された有効レベルを取得して、トレースするイベントのレベルを示します。 プロバイダーは、ControlCallback 関数からこの関数を呼び出します。
GetTraceLoggerHandle RegisterTraceGuids ベース ("Classic") イベント プロバイダーは、GetTraceLoggerHandle 関数を使用して、イベントを書き込むイベント トレース セッションのハンドルを取得します。 プロバイダーは、ControlCallback 関数からこの関数を呼び出します。
OpenTraceA OpenTraceA (ANSI) 関数 (evntrace.h) は、ETW リアルタイム トレース セッションまたは ETW ログ ファイルからイベントを使用するための ETW トレース処理ハンドルを開きます。
OpenTraceFromBufferStream ファイルまたはアクティブなセッションに直接接続されていないトレース処理セッションを作成します。
OpenTraceFromFile Tracelog .etl ファイルを処理するトレース処理セッションを作成します。
OpenTraceFromRealTimeLogger ETW リアルタイム トレース セッションまたは ETW ログ ファイルからイベントを使用するための ETW トレース処理ハンドルを開きます。
OpenTraceFromRealTimeLoggerWithAllocationOptions アクティブなリアルタイム ETW セッションにアタッチされたトレース処理セッションを作成します。
OpenTraceW OpenTraceW (Unicode) 関数 (evntrace.h) は、ETW リアルタイム トレース セッションまたは ETW ログ ファイルからイベントを使用するための ETW トレース処理ハンドルを開きます。
ProcessTrace 1 つ以上のトレース処理セッションからコンシューマーにイベントを配信します。
ProcessTraceAddBufferToBufferStream OpenTraceFromBufferStream によって作成された処理セッションに ETW トレース バッファーを提供します。
ProcessTraceBufferDecrementReference ProcessTraceBufferIncrementReference によって追加された Buffer への参照を解放します。
ProcessTraceBufferIncrementReference 指定された Buffer で BufferCallback 中に呼び出され、呼び出し元がバッファーで実行されるまで解放されないようにします。
QueryAllTracesA QueryAllTracesA (ANSI) 関数 (evntrace.h) 関数は、呼び出し元が照会できるすべてのイベント トレース セッションのプロパティと統計を取得します。
QueryAllTracesW QueryAllTracesW (Unicode) 関数 (evntrace.h) 関数は、呼び出し元が照会できるすべてのイベント トレース セッションのプロパティと統計を取得します。
QueryTraceA QueryTraceA (ANSI) 関数 (evntrace.h) は、指定されたイベント トレース セッションのプロパティ設定とセッション統計を取得します。
QueryTraceProcessingHandle OpenTrace によって開かれた ETW トレース処理セッションに関する情報を取得します。
QueryTraceW QueryTraceW (Unicode) 関数 (evntrace.h) は、指定されたイベント トレース セッションのプロパティ設定とセッション統計を取得します。
RegisterTraceGuidsA RegisterTraceGuidsA (ANSI) 関数 (evntrace.h) は古い関数であり、新しいコードでは、指定された代替を使用する必要があります。
RegisterTraceGuidsW RegisterTraceGuidsW (Unicode) 関数 (evntrace.h) は古い関数であり、新しいコードでは、指定された代替手段を使用する必要があります。
RemoveTraceCallback RemoveTraceCallback 関数は、EventCallback 関数がイベント トレース クラスのイベントを受信するのを停止します。 この関数は、現在使用されていません。
SetTraceCallback SetTraceCallback 関数は、指定されたイベント トレース クラスのイベントを処理する EventCallback 関数を指定します。 この関数は、現在使用されていません。
StartTraceA StartTrace 関数は、イベント トレース セッションを開始します。 (ANSI)
StartTraceW StartTrace 関数は、イベント トレース セッションを開始します。 (Unicode)
StopTraceA StopTraceA (ANSI) 関数 (evntrace.h) は、指定されたイベント トレース セッションを停止します。 ControlTrace 関数は、この関数よりも優先されます。
StopTraceW StopTraceW (Unicode) 関数 (evntrace.h) は、指定されたイベント トレース セッションを停止します。 ControlTrace 関数は、この関数よりも優先されます。
TraceEvent RegisterTraceGuids ベース ("Classic") イベント プロバイダーは、TraceEvent 関数を使用して、構造化イベントをイベント トレース セッションに送信します。
TraceEventInstance RegisterTraceGuids ベースの ("Classic") イベント プロバイダーは、TraceEventInstance 関数を使用して、インスタンス識別子を持つイベント トレース セッションに構造化イベントを送信します。
TraceMessage RegisterTraceGuids ベース ("クラシック") イベント プロバイダーは、TraceMessage 関数を使用して、メッセージ ベース (TMF ベースの WPP) イベントをイベント トレース セッションに送信します。
TraceMessageVa RegisterTraceGuids ベース ("クラシック") イベント プロバイダーは、TraceMessageVa 関数を使用して、メッセージ ベース (TMF ベースの WPP) イベントを、va_list パラメーターを使用してイベント トレース セッションに送信します。
TraceQueryInformation イベント トレース セッションに関する情報を提供します。
TraceSetInformation イベント トレース セッション設定を構成します。
UnregisterTraceGuids RegisterTraceGuids を使用して登録された "クラシック" (Windows 2000 スタイル) ETW イベント トレース プロバイダーの登録を解除します。
UpdateTraceA UpdateTraceA (ANSI) 関数 (evntrace.h) は、指定されたイベント トレース セッションのプロパティ設定を更新します。
UpdateTraceW UpdateTraceW (Unicode) 関数 (evntrace.h) は、指定されたイベント トレース セッションのプロパティ設定を更新します。

コールバック関数

PETW_BUFFER_CALLBACK ProcessTrace によって呼び出される BufferCallback の関数定義。
PETW_BUFFER_COMPLETION_CALLBACK ProcessTraceAddBufferToBufferStream がバッファーで終了したときに発生するコールバックの関数定義。 このコールバックは、通常、必要に応じてバッファーを解放する必要があります
PEVENT_CALLBACK ETW イベント コンシューマーは、トレース処理セッションからイベントを受信するために、このコールバックを実装します。 EventRecordCallback コールバックは、このコールバックよりも優先されます。
PEVENT_RECORD_CALLBACK ETW イベント コンシューマーは、トレース処理セッションからイベントを受信するために、このコールバックを実装します。 PEVENT_RECORD_CALLBACK型は、このコールバック関数へのポインターを定義します。 EventRecordCallback は、アプリケーション定義関数名のプレースホルダーです。
PEVENT_TRACE_BUFFER_CALLBACKA PEVENT_TRACE_BUFFER_CALLBACKA (ANSI) (evntrace.h) 関数は、トレース処理セッション中に ETW が送信するイベントの各バッファーに関する統計情報を取得します。
PEVENT_TRACE_BUFFER_CALLBACKW PEVENT_TRACE_BUFFER_CALLBACKW (Unicode) (evntrace.h) 関数は、トレース処理セッション中に ETW が送信するイベントの各バッファーに関する統計情報を取得します。
WMIDPREQUEST RegisterTraceGuids ベース ("クラシック") イベント プロバイダーは、コントローラーから通知を受信するためにこの関数を実装します。 WMIDPREQUEST 型は、このコールバック関数へのポインターを定義します。 ControlCallback は、アプリケーション定義関数名のプレースホルダーです。

構造

CLASSIC_EVENT_ID 呼び出し履歴トレースを有効にするカーネル イベントを識別します。
ENABLE_TRACE_PARAMETERS EnableTraceEx2 を使用してプロバイダーを有効にするために使用される情報が含まれます。
ENABLE_TRACE_PARAMETERS_V1 EnableTraceEx2 を使用してプロバイダーを有効にするために使用される情報が含まれます。 この構造は廃止されました。
ETW_BUFFER_CALLBACK_INFORMATION ConsumerInfo パラメーターとして BufferCallback に提供され、現在の処理セッションの詳細を提供します。
ETW_BUFFER_CONTEXT イベントに関するコンテキスト情報を提供します。
ETW_BUFFER_HEADER ETW バッファーのヘッダー構造。
ETW_OPEN_TRACE_OPTIONS OpenTraceFromBufferStream、OpenTraceFromFile、OpenTraceFromRealTimeLogger、OpenTraceFromRealTimeLoggerWithAllocationOptions 関数に構成パラメーターを提供します。
ETW_TRACE_PARTITION_INFORMATION ETW トレースから取得されたパーティション情報が含まれます。
EVENT_INSTANCE_HEADER EVENT_INSTANCE_HEADER構造体には、TraceEventInstance によって書き込まれたすべてのイベントに共通の標準イベント トレース情報が含まれています。
EVENT_INSTANCE_INFO EVENT_INSTANCE_INFO構造体は、TraceEventInstance の登録されたイベント トレース クラスに一意のトランザクション識別子をマップします。
EVENT_TRACE EVENT_TRACE構造体は、イベント トレース コンシューマーにイベント情報を配信するために使用されます。
EVENT_TRACE_HEADER EVENT_TRACE_HEADER構造体には、TraceEvent によって書き込まれるすべてのイベントに共通する標準のイベント トレース情報が含まれています。
EVENT_TRACE_LOGFILEA EVENT_TRACE_LOGFILEA (ANSI) 構造体 (evntrace.h) には、トレース データ ソースに関する情報が格納されます。
EVENT_TRACE_LOGFILEW EVENT_TRACE_LOGFILEW (Unicode) 構造体 (evntrace.h) には、トレース データ ソースに関する情報が格納されます。
EVENT_TRACE_PROPERTIES EVENT_TRACE_PROPERTIES構造体にはイベント トレース セッションに関する情報が含まれており、StartTrace や ControlTrace などの API で使用されます。
EVENT_TRACE_PROPERTIES_V2 EVENT_TRACE_PROPERTIES_V2構造体にはイベント トレース セッションに関する情報が含まれており、StartTrace や ControlTrace などの API で使用されます。
MOF_FIELD MOF_FIELD構造体を使用して、イベント データを EVENT_TRACE_HEADER または EVENT_INSTANCE_HEADER 構造体に追加できます。
TRACE_ENABLE_INFO セッションと、プロバイダーを有効にするためにセッションが使用した情報を定義します。
TRACE_GUID_INFO EnumerateTraceGuidsEx によって返されます。 プロバイダーを有効にしたセッションの一覧のヘッダーを定義します。
TRACE_GUID_PROPERTIES EnumerateTraceGuids によって返されます。 イベント トレース プロバイダーに関する情報が含まれます。
TRACE_GUID_REGISTRATION イベント トレース クラスを登録するために RegisterTraceGuids と共に使用されます。
TRACE_LOGFILE_HEADER TRACE_LOGFILE_HEADER構造体には、イベント トレース セッションとそのイベントに関する情報が含まれています。
TRACE_PERIODIC_CAPTURE_STATE_INFO TraceQueryInformation および TraceSetInformation と共に使用して、定期的なキャプチャ状態に関連する情報を取得または設定します。
TRACE_PROVIDER_INSTANCE_INFO プロバイダー GUID のインスタンスを定義します。
TRACE_VERSION_INFO トレース ログ セッションのバージョン情報を決定します。

列挙

ETW_PROCESS_HANDLE_INFO_TYPE トレース処理セッションで実行される操作を指定します。
ETW_PROCESS_TRACE_MODES サポートされているプロセス トレース モードを指定します。
TRACE_QUERY_INFO_CLASS EnumerateTraceGuidsEx および TraceSetInformation と共に使用して、トレース情報の種類を指定します。