グローバル静的関数のプロファイル
ここでは、プロファイル API で使用されるアンマネージ API 関数について説明します。
このセクションの内容
.NET Framework Version 1 プロファイル関数
FunctionEnter 関数
関数に制御が渡されていることをプロファイラーに通知します。 .NET Framework 2.0 での使用は推奨されません。FunctionLeave 関数
関数が呼び出し元に戻ろうとしていることをプロファイラーに通知します。 .NET Framework 2.0 での使用は推奨されません。FunctionTailcall 関数
現在実行中の関数が、別の関数への tail 呼び出しを実行する直前であることを、プロファイラーに通知します。 .NET Framework 2.0 での使用は推奨されません。
.NET Framework Version 2 プロファイル関数
FunctionIDMapper 関数
関数の特定の識別子が、その関数の FunctionEnter2、FunctionLeave2、および FunctionTailcall2 の各コールバックで使用される代替 ID に再割り当てされる可能性があることをプロファイラーに通知します。 また、プロファイラーはその関数のコールバックを受信するかどうかを示すことができます。FunctionEnter2 関数
関数に制御が渡されていることをプロファイラーに通知し、スタック フレームと関数の引数に関する情報を提供します。 .NET Framework 4 では使用されなくなりました。FunctionLeave2 関数
関数が呼び出し元に戻る直前であることをプロファイラーに通知し、スタック フレームと関数の戻り値に関する情報を提供します。 .NET Framework 4 では使用されなくなりました。FunctionTailcall2 関数
現在実行中の関数が、別の関数への tail 呼び出しを実行する直前であることをプロファイラーに通知し、スタック フレームに関する情報を提供します。 .NET Framework 4 では使用されなくなりました。StackSnapshotCallback 関数
スタック ウォーク中に、スタック上の各マネージ フレームおよびアンマネージ フレームの各実行に関する情報をプロファイラーに提供します。これは、ICorProfilerInfo2::DoStackSnapshot メソッドによって開始されます。
.NET Framework Version 4 プロファイル関数
FunctionIDMapper2 関数
関数の特定の識別子が、FunctionEnter3、FunctionLeave3、および FunctionTailcall3、またはその関数の FunctionEnter3WithInfo、FunctionLeave3WithInfo、および FunctionTailcall3WithInfo の各コールバックで使用される代替 ID に再割り当てされることをプロファイラーに通知します。 また、プロファイラーはその関数のコールバックを受信するかどうかを示すことができます。FunctionIDMapper2 は、FunctionIDMapper 関数を clientData パラメーターで拡張します。プロファイラーは、必要に応じて、このパラメーターを使用してランタイム間のあいまいさを解決します。
FunctionEnter3 関数
関数に制御が渡されていることをプロファイラーに通知します。FunctionEnter3WithInfo 関数
コントロールが関数に渡されることをプロファイラーに通知し、ICorProfilerInfo3::GetFunctionEnter3Info に渡してスタック フレームと関数の引数を取得できるハンドルを提供します。FunctionLeave3 関数
関数から制御が戻されていることをプロファイラーに通知します。FunctionLeave3WithInfo 関数
コントロールが関数から返されることをプロファイラーに通知し、ICorProfilerInfo3::GetFunctionLeave3Info に渡してスタック フレームと戻り値を取得できるハンドルを提供します。FunctionTailcall3 関数
現在実行中の関数が、別の関数への tail 呼び出しを実行する直前であることを、プロファイラーに通知します。FunctionTailcall3WithInfo 関数
現在実行している関数が別の関数に対する tail 呼び出しを実行する直前であることをプロファイラーに通知し、ICorProfilerInfo3::GetFunctionTailcall3Info に渡してスタック フレームを取得できるハンドルを提供します。