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

ICorProfilerInfo12

COM
IID27b24ccd-1cb1-47c5-96ee-98190dc30959継承元ICorProfilerInfo11自前メソッド開始 vtbl101

メソッド 7

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

vtbl 101 HRESULT EventPipeStartSession(DWORD cProviderConfigs, COR_PRF_EVENTPIPE_PROVIDER_CONFIG* pProviderConfigs, BOOL requestRundown, ULONGLONG* pSession)
cProviderConfigsDWORDinpProviderConfigs 配列に含まれるプロバイダー構成の数を指定する。
pProviderConfigsCOR_PRF_EVENTPIPE_PROVIDER_CONFIG*inセッションで有効化する EventPipe プロバイダーの構成を表す COR_PRF_EVENTPIPE_PROVIDER_CONFIG 配列へのポインタである。
requestRundownBOOLinセッション終了時にランダウンイベントを要求する場合に TRUE を指定する。
pSessionULONGLONG*out開始した EventPipe セッションの識別子を受け取る。
vtbl 102 HRESULT EventPipeAddProviderToSession(ULONGLONG session, COR_PRF_EVENTPIPE_PROVIDER_CONFIG providerConfig)
sessionULONGLONGinプロバイダーを追加する対象の EventPipe セッション識別子を指定する。
providerConfigCOR_PRF_EVENTPIPE_PROVIDER_CONFIGinセッションに追加するプロバイダーの構成を表す COR_PRF_EVENTPIPE_PROVIDER_CONFIG 構造体である。
vtbl 103 HRESULT EventPipeStopSession(ULONGLONG session)
sessionULONGLONGin停止する EventPipe セッションの識別子を指定する。
vtbl 104 HRESULT EventPipeCreateProvider(LPWSTR providerName, UINT_PTR* pProvider)
providerNameLPWSTRin作成する EventPipe プロバイダーの名前を指定する。
pProviderUINT_PTR*out作成されたプロバイダーのハンドルを受け取る。
vtbl 105 HRESULT EventPipeGetProviderInfo(UINT_PTR provider, DWORD cchName, DWORD* pcchName, LPWSTR providerName)
providerUINT_PTRin情報を取得する EventPipe プロバイダーのハンドルを指定する。
cchNameDWORDinproviderName バッファが保持できる文字数(終端 NULL を含む)を指定する。
pcchNameDWORD*outプロバイダー名に必要な実際の文字数を受け取る。
providerNameLPWSTRoutプロバイダーの名前を受け取るバッファである。
vtbl 106 HRESULT EventPipeDefineEvent(UINT_PTR provider, LPWSTR eventName, DWORD eventID, ULONGLONG keywords, DWORD eventVersion, DWORD level, BYTE opcode, BOOL needStack, DWORD cParamDescs, COR_PRF_EVENTPIPE_PARAM_DESC* pParamDescs, UINT_PTR* pEvent)
providerUINT_PTRinイベントを定義する対象の EventPipe プロバイダーのハンドルを指定する。
eventNameLPWSTRin定義するイベントの名前を指定する。
eventIDDWORDinイベントを識別する数値 ID を指定する。
keywordsULONGLONGinイベントを分類するためのキーワードビットマスクを指定する。
eventVersionDWORDinイベントスキーマのバージョン番号を指定する。
levelDWORDinイベントの詳細度(トレースレベル)を指定する。
opcodeBYTEinイベントの種類を示すオペコードを指定する。
needStackBOOLinイベント発生時にスタックトレースを取得する場合に TRUE を指定する。
cParamDescsDWORDinpParamDescs 配列に含まれるパラメータ記述子の数を指定する。
pParamDescsCOR_PRF_EVENTPIPE_PARAM_DESC*inイベントの各パラメータを記述する COR_PRF_EVENTPIPE_PARAM_DESC 配列へのポインタである。
pEventUINT_PTR*out定義されたイベントのハンドルを受け取る。
vtbl 107 HRESULT EventPipeWriteEvent(UINT_PTR event, DWORD cData, COR_PRF_EVENT_DATA* data, GUID* pActivityId, GUID* pRelatedActivityId)
eventUINT_PTRin書き込むイベントのハンドルを指定する。
cDataDWORDindata 配列に含まれるイベントデータ要素の数を指定する。
dataCOR_PRF_EVENT_DATA*inイベントのペイロードを構成する COR_PRF_EVENT_DATA 配列へのポインタである。
pActivityIdGUID*inイベントに関連付けるアクティビティ ID の GUID へのポインタである。不要なら NULL を指定できる。
pRelatedActivityIdGUID*in関連アクティビティ ID の GUID へのポインタである。不要なら NULL を指定できる。

HSP用 COM定義

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

出力引数: 
#define global IID_ICorProfilerInfo12 "{27B24CCD-1CB1-47C5-96EE-98190DC30959}"
#usecom global ICorProfilerInfo12 IID_ICorProfilerInfo12 "{}"
#comfunc global ICorProfilerInfo12_EventPipeStartSession          101 int,var,int,var
#comfunc global ICorProfilerInfo12_EventPipeAddProviderToSession  102 int64,int
#comfunc global ICorProfilerInfo12_EventPipeStopSession           103 int64
#comfunc global ICorProfilerInfo12_EventPipeCreateProvider        104 wstr,var
#comfunc global ICorProfilerInfo12_EventPipeGetProviderInfo       105 sptr,int,var,var
#comfunc global ICorProfilerInfo12_EventPipeDefineEvent           106 sptr,wstr,int,int64,int,int,int,int,int,var,var
#comfunc global ICorProfilerInfo12_EventPipeWriteEvent            107 sptr,int,var,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。