ICorProfilerInfo3 インターフェイス

コード プロファイラーが共通言語ランタイム (CLR: Common Language Runtime) とやり取りして、イベント監視を制御したり、情報を要求したりするために使用する各種メソッドを提供します。 ICorProfilerInfo3 インターフェイスは、ICorProfilerInfo2 インターフェイスの機能を拡張するインターフェイスです。 このインターフェイスには、.NET Framework 4 以降のバージョンでサポートされる新しいメソッドが用意されています。

メソッド

メソッド 説明
EnumJITedFunctions メソッド 以前に JIT でコンパイルされたすべての関数に対する列挙子を返します。
EnumModules メソッド アプリケーションに読み込まれるマネージド モジュールのコレクションを順番に反復処理するメソッドを提供する列挙子を返します。
GetAppDomainsContainingModule メソッド 指定したモジュールが読み込まれているアプリケーション ドメインの識別子を取得します。
GetFunctionEnter3Info メソッド FunctionEnter3WithInfo 関数によってプロファイラーに報告される関数のスタック フレームおよび引数情報を提供します。FunctionEnter3WithInfo コールバック中にのみ呼び出すことができます。
GetFunctionLeave3Info メソッド FunctionLeave3WithInfo function 関数によってプロファイラーに報告される関数のスタック フレームおよび戻り値を提供します。FunctionLeave3WithInfo コールバック中にのみ呼び出すことができます。
GetFunctionTailcall3Info メソッド FunctionTailcall3WithInfo 関数によってプロファイラーに報告される関数のスタック フレームを提供します。FunctionTailcall3WithInfo コールバック中にのみ呼び出すことができます。
GetModuleInfo2 メソッド モジュール ID を指定して、モジュールのファイル名、モジュールの親アセンブリの ID、およびモジュールのプロパティを示すビットマスクを返します。
GetRuntimeInformation メソッド プロファイリングされているランタイムに関するバージョン情報を提供します。
GetStringLayout2 メソッド 文字列オブジェクトのレイアウトに関する情報を取得します。
GetThreadStaticAddress2 メソッド 指定したスレッドおよびアプリケーション ドメインのスコープ内にある、指定したスレッド内静的フィールドのアドレスを取得します。
RequestProfilerDetach メソッド プロファイラーをデタッチするようにランタイムに指示します。
SetEnterLeaveFunctionHooks3 メソッド FunctionEnter3FunctionLeave3FunctionTailcall3 の各関数で呼び出されるプロファイラー実装関数を指定します。
SetEnterLeaveFunctionHooks3WithInfo メソッド マネージド関数の FunctionEnter3WithInfo フック、FunctionLeave3WithInfo フック、FunctionTailcall3WithInfo フックで呼び出されるプロファイラー実装関数を指定します。
SetFunctionIDMapper2 メソッド FunctionID 値を代替値に対応付けるために呼び出すプロファイラー実装関数を指定します。代替値は、プロファイラーの関数の開始フックと終了フックに渡されます。 このメソッドは、ICorProfilerInfo::SetFunctionIDMapper を、プロファイラーがランタイム間のあいまいさを解決するために使用するパラメーターで拡張します。

解説

CLR は、ICorProfilerInfo3 インターフェイスのメソッドを、フリー スレッド モデルを使用して実装します。 各メソッドが、成功または失敗を示す HRESULT を返します。 返される可能性があるリターン コードの一覧については、CorError.h ファイルを参照してください。

CLR は初期化時に ICorProfilerInfo3 インターフェイスを各コード プロファイラーに渡します。このとき、ICorProfilerCallback::Initialize メソッドまたは ICorProfilerCallback3::InitializeForAttach メソッドのプロファイラーの実装を使用します。 その後、コード プロファイラーは ICorProfilerInfo3 メソッドを呼び出して、CLR の制御下で実行中のマネージド コードに関する情報を取得できます。

必要条件

:システム要件」を参照してください。

ヘッダー : CorProf.idl、CorProf.h

ライブラリ: CorGuids.lib

.NET Framework のバージョン: 4 以降で使用可能

関連項目