ICorProfilerInfo インターフェイス
コード プロファイラーが共通言語ランタイム (CLR: Common Language Runtime) とやり取りして、イベント監視および要求情報を制御するために使用する各種メソッドを提供します。
.gif "メモ") メモ |
|---|
ICorProfilerInfo インターフェイスの各メソッドが、成功または失敗を示す HRESULT を返します。使用できるリターン コードの一覧については、CorError.h を参照してください。 |
メソッド
メソッド |
説明 |
|---|---|
インプロセス デバッグ サポートを初期化します。 このメソッドは、.NET Framework Version 2.0 で互換性のために残されています。 |
|
インプロセス デバッグ セッションをシャットダウンします。 このメソッドは、.NET Framework Version 2.0 で互換性のために残されています。 |
|
ランタイム内で強制的にガベージ コレクションを実行します。 |
|
指定したアプリケーション ドメインの情報を取得します。 |
|
指定したアセンブリの情報を取得します。 |
|
ClassID (ObjectID を指定したオブジェクトの) を取得します。 |
|
指定したメタデータ トークンのクラスの ID を取得します。 このメソッドは、.NET Framework Version 2.0 で互換性のために残されています。 代わりに ICorProfilerInfo2::GetClassFromTokenAndTypeArgs メソッドを使用してください。 |
|
指定したクラスの親モジュールおよびメタデータ トークンを取得します。 |
|
指定した関数 ID に関連付けられているネイティブ コードの範囲を取得します。 このメソッドは、互換性のために残されています。 代わりに ICorProfilerInfo2::GetCodeInfo2 メソッドを使用してください。 |
|
現在のスレッドがマネージ スレッドの場合、その ID を取得します。 |
|
プロファイラーが CLR からイベント通知を受け取る現在のイベント カテゴリを取得します。 |
|
マネージ コードの命令ポインターを FunctionID にマップします。 |
|
関数の ID を取得します。 このメソッドは、.NET Framework Version 2.0 で互換性のために残されています。 代わりに ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs メソッドを使用してください。 |
|
指定した関数の親クラスおよびメタデータ トークンを取得します。 |
|
スレッドの ID を Win32 スレッド ハンドルに対応付けます。 |
|
Microsoft Intermediate Language (MSIL) コード内の、ヘッダー位置から始まるメソッド本体へのポインターを取得します。 |
|
MSIL コード内のメソッド本体のスワップに使用するメモリを割り当てるメソッドを提供するインターフェイスを取得します。 |
|
指定した関数に含まれているコードの MSIL オフセットからネイティブ オフセットへの対応付けを取得します。 |
|
ICorDebugProcess インターフェイスに対して照会できるオブジェクトを取得します。 このメソッドは、.NET Framework Version 2.0 で互換性のために残されています。 |
|
ICorDebugThread インターフェイスに対して照会できるオブジェクトを取得します。 このメソッドは、.NET Framework Version 2.0 で互換性のために残されています。 |
|
モジュール ID を指定して、モジュールのファイル名とモジュールの親アセンブリの ID を取得します。 |
|
指定したモジュールに割り当てられるメタデータ インターフェイス インスタンスを取得します。 |
|
指定したオブジェクトのサイズを取得します。 |
|
指定したスレッドに現在関連付けられているコンテキスト ID を取得します。 |
|
指定したスレッドの現在の Win32 スレッド識別子を取得します。 |
|
指定した関数のトークンに対して使用できるメタデータ トークンおよびメタデータ インターフェイスのインスタンスを取得します。 |
|
指定したクラスが配列クラスかどうかを判断します。 |
|
マネージ関数の "enter"、"leave"、および "tailcall" フックで呼び出すプロファイラー実装関数を指定します。 |
|
プロファイラーが CLR から通知を受け取るイベントの種類を指定する値を設定します。 |
|
FunctionID 値を代替値に対応付けるために呼び出すプロファイラー実装関数を指定します。代替値は、プロファイラーの関数の開始フックと終了フックに渡されます。 |
|
実装されていません。 使用しないでください。 |
|
指定したモジュール内の指定した関数の本体を置き換えます。 |
|
指定した関数の元の MSIL のオフセットを、その関数のプロファイラーで変更された MSIL の新しいオフセットに対応付ける方法を指定します。 |
解説
プロファイラーは ICorProfilerInfo インターフェイスのメソッドを呼び出し、CLR とやり取りしてイベント監視および要求情報を制御します。
ICorProfilerInfo インターフェイスのメソッドは、フリー スレッド モデルを使用して CLR によって実装されます。 各メソッドが、成功または失敗を示す HRESULT を返します。 使用できるリターン コードの一覧については、CorError.h を参照してください。
CLR は、プロファイラーの ICorProfilerCallback::Initialize の実装を使用して、初期化中に ICorProfilerInfo インターフェイスを各コード プロファイラーに渡します。 次に、コード プロファイラーが ICorProfilerInfo インターフェイスのメソッドを呼び出して、CLR が実行しているマネージ コードの情報を取得できます。
要件
プラットフォーム: 「.NET Framework システム要件」を参照
ヘッダー: CorProf.idl、CorProf.h
ライブラリ: CorGuids.lib
.NET Framework のバージョン: 4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0