ホーム › System.Diagnostics.Etw › ITraceEventCallback
ITraceEventCallback
COM公式ドキュメント
トレース処理の開始・終了時やイベントのログ記録時に、ETW がリロガーへ情報を提供するために使用します。
解説(Remarks)
このインターフェイスは、IA64 アーキテクチャの Windows 7 ではサポートされていません。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT OnBeginProcessTrace(ITraceEvent* HeaderEvent, ITraceRelogger* Relogger)
トレースが開始されようとしていることを通知し、リログ処理を開始できるようにします。
| HeaderEvent | ITraceEvent* | in | ヘッダーイベントへのポインターを指定します。 |
| Relogger | ITraceRelogger* | in | 実際のイベント挿入、新規イベントの合成、既存イベントの複製を行う API を公開する ITraceRelogger インターフェイスへのポインターを指定します。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
vtbl 4 HRESULT OnFinalizeProcessTrace(ITraceRelogger* Relogger)
トレースが終了されようとしていることを通知し、リログ処理を最終化できるようにします。
| Relogger | ITraceRelogger* | in | このコールバックの登録およびこのトレースのリログに使用されたトレースリロガー。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
vtbl 5 HRESULT OnEvent(ITraceEvent* Event, ITraceRelogger* Relogger)
リロガーに関連付けられたトレースストリーム上でイベントを受信したことを通知します。
| Event | ITraceEvent* | in | ログ記録されるイベント。 |
| Relogger | ITraceRelogger* | in | このコールバックの登録およびこのトレースのリログに使用されたトレースリロガー。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ITraceEventCallback "{3ED25501-593F-43E9-8F38-3AB46F5A4A52}"
#usecom global ITraceEventCallback IID_ITraceEventCallback "{}"
#comfunc global ITraceEventCallback_OnBeginProcessTrace 3 sptr,sptr
#comfunc global ITraceEventCallback_OnFinalizeProcessTrace 4 sptr
#comfunc global ITraceEventCallback_OnEvent 5 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。