Win32 API 日本語リファレンス
ホームSystem.Diagnostics.Etw › ITraceEvent

ITraceEvent

COM
IID8cc97f40-9028-4ff3-9b62-7d1f79ca7bcb継承元IUnknown自前メソッド開始 vtbl3

メソッド 12

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT Clone(ITraceEvent** NewEvent)
NewEventITraceEvent**outこのトレースイベントを複製した新しい ITraceEvent インスタンスを受け取る。
vtbl 4 HRESULT GetUserContext(void** UserContext)
UserContextvoid**outイベントに関連付けられたユーザー定義のコンテキストポインタを受け取る。
vtbl 5 HRESULT GetEventRecord(EVENT_RECORD** EventRecord)
EventRecordEVENT_RECORD**outこのイベントに対応する EVENT_RECORD 構造体へのポインタを受け取る。
vtbl 6 HRESULT SetPayload(BYTE* Payload, DWORD PayloadSize)
PayloadBYTE*inイベントに設定するペイロードデータへのポインタである。
PayloadSizeDWORDinPayload データのサイズ(バイト数)を指定する。
vtbl 7 HRESULT SetEventDescriptor(EVENT_DESCRIPTOR* EventDescriptor)
EventDescriptorEVENT_DESCRIPTOR*inイベントに設定する EVENT_DESCRIPTOR 構造体へのポインタである。
vtbl 8 HRESULT SetProcessId(DWORD ProcessId)
ProcessIdDWORDinイベントに設定するプロセス ID を指定する。
vtbl 9 HRESULT SetProcessorIndex(DWORD ProcessorIndex)
ProcessorIndexDWORDinイベントを発生させたプロセッサのインデックスを指定する。
vtbl 10 HRESULT SetThreadId(DWORD ThreadId)
ThreadIdDWORDinイベントに設定するスレッド ID を指定する。
vtbl 11 HRESULT SetThreadTimes(DWORD KernelTime, DWORD UserTime)
KernelTimeDWORDinイベントに設定するカーネルモードでの実行時間を指定する。
UserTimeDWORDinイベントに設定するユーザーモードでの実行時間を指定する。
vtbl 12 HRESULT SetActivityId(GUID* ActivityId)
ActivityIdGUID*inイベントに設定するアクティビティ ID(GUID)へのポインタである。
vtbl 13 HRESULT SetTimeStamp(LONGLONG* TimeStamp)
TimeStampLONGLONG*inイベントに設定するタイムスタンプ値へのポインタである。
vtbl 14 HRESULT SetProviderId(GUID* ProviderId)
ProviderIdGUID*inイベントに設定するプロバイダ ID(GUID)へのポインタである。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_ITraceEvent "{8CC97F40-9028-4FF3-9B62-7D1F79CA7BCB}"
#usecom global ITraceEvent IID_ITraceEvent "{}"
#comfunc global ITraceEvent_Clone               3 sptr
#comfunc global ITraceEvent_GetUserContext      4 sptr
#comfunc global ITraceEvent_GetEventRecord      5 var
#comfunc global ITraceEvent_SetPayload          6 var,int
#comfunc global ITraceEvent_SetEventDescriptor  7 var
#comfunc global ITraceEvent_SetProcessId        8 int
#comfunc global ITraceEvent_SetProcessorIndex   9 int
#comfunc global ITraceEvent_SetThreadId         10 int
#comfunc global ITraceEvent_SetThreadTimes      11 int,int
#comfunc global ITraceEvent_SetActivityId       12 var
#comfunc global ITraceEvent_SetTimeStamp        13 var
#comfunc global ITraceEvent_SetProviderId       14 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。