ホーム › System.Diagnostics.Etw › ITraceRelogger
ITraceRelogger
COMメソッド 9
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT AddLogfileTraceStream(LPWSTR LogfileName, void* UserContext, ULONGLONG* TraceStreamId)
| LogfileName | LPWSTR | in | 入力元として追加する ETL ログファイルのパスを指定する。 |
| UserContext | void* | in | このトレースストリームに関連付けるユーザー定義のコンテキストポインタである。 |
| TraceStreamId | ULONGLONG* | out | 追加されたトレースストリームを識別する ID を受け取る。 |
vtbl 4 HRESULT AddRealtimeTraceStream(LPWSTR LoggerName, void* UserContext, ULONGLONG* TraceStreamId)
| LoggerName | LPWSTR | in | 入力元として追加するリアルタイムトレースセッションのロガー名を指定する。 |
| UserContext | void* | in | このトレースストリームに関連付けるユーザー定義のコンテキストポインタである。 |
| TraceStreamId | ULONGLONG* | out | 追加されたトレースストリームを識別する ID を受け取る。 |
vtbl 5 HRESULT RegisterCallback(ITraceEventCallback* Callback)
| Callback | ITraceEventCallback* | in | イベント処理を受け取るコールバック ITraceEventCallback を指定する。 |
vtbl 6 HRESULT Inject(ITraceEvent* Event)
| Event | ITraceEvent* | in | 出力ストリームに挿入するトレースイベント ITraceEvent を指定する。 |
vtbl 7 HRESULT CreateEventInstance(ULONGLONG TraceStreamId, DWORD Flags, ITraceEvent** Event)
| TraceStreamId | ULONGLONG | in | 新しいイベントを関連付けるトレースストリームの ID を指定する。 |
| Flags | DWORD | in | イベント生成時の挙動を制御するフラグを指定する。 |
| Event | ITraceEvent** | out | 新しく生成された ITraceEvent インスタンスを受け取る。 |
vtbl 8 HRESULT ProcessTrace()
| LogfileName | LPWSTR | in | リログ結果を書き出す出力 ETL ファイルのパスを指定する。 |
| CompressionMode | BOOLEAN | in | 出力ファイルを圧縮するかどうかを指定するブール値である。 |
vtbl 11 HRESULT Cancel()
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_ITraceRelogger "{F754AD43-3BCC-4286-8009-9C5DA214E84E}" #usecom global ITraceRelogger IID_ITraceRelogger "{}" #comfunc global ITraceRelogger_AddLogfileTraceStream 3 wstr,sptr,var #comfunc global ITraceRelogger_AddRealtimeTraceStream 4 wstr,sptr,var #comfunc global ITraceRelogger_RegisterCallback 5 sptr #comfunc global ITraceRelogger_Inject 6 sptr #comfunc global ITraceRelogger_CreateEventInstance 7 int64,int,sptr #comfunc global ITraceRelogger_ProcessTrace 8 #comfunc global ITraceRelogger_SetOutputFilename 9 wstr #comfunc global ITraceRelogger_SetCompressionMode 10 int #comfunc global ITraceRelogger_Cancel 11 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ITraceRelogger "{F754AD43-3BCC-4286-8009-9C5DA214E84E}" #usecom global ITraceRelogger IID_ITraceRelogger "{}" #comfunc global ITraceRelogger_AddLogfileTraceStream 3 wstr,sptr,sptr #comfunc global ITraceRelogger_AddRealtimeTraceStream 4 wstr,sptr,sptr #comfunc global ITraceRelogger_RegisterCallback 5 sptr #comfunc global ITraceRelogger_Inject 6 sptr #comfunc global ITraceRelogger_CreateEventInstance 7 int64,int,sptr #comfunc global ITraceRelogger_ProcessTrace 8 #comfunc global ITraceRelogger_SetOutputFilename 9 wstr #comfunc global ITraceRelogger_SetCompressionMode 10 int #comfunc global ITraceRelogger_Cancel 11 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。