グローバル静的関数のプロファイル

[アーティクル]
05/10/2023

このセクションでは、プロファイル API によって使用されるアンマネージド API 関数について説明します。

このセクションの内容

.NET Framework バージョン 1 のプロファイリング関数

FunctionEnter 関数
関数に制御が渡されていることをプロファイラーに通知します。 .NET Framework 2.0 で非推奨になりました。

FunctionLeave 関数
関数が呼び出し元に戻ろうとしていることをプロファイラーに通知します。 .NET Framework 2.0 で非推奨になりました。

FunctionTailcall 関数
現在実行中の関数によって別の関数の末尾呼び出しが実行されようとしていることをプロファイラーに通知します。 .NET Framework 2.0 で非推奨になりました。

.NET Framework バージョン 2 のプロファイリング関数

FunctionIDMapper 関数
関数の特定の識別子が、その関数の FunctionEnter2、FunctionLeave2、FunctionTailcall2 のコールバックで使用される代替 ID に再マップされる可能性があることをプロファイラーに通知します。またこれにより、プロファイラーはその関数のコールバックを受信するかどうかを示すことができます

FunctionEnter2 関数
制御が関数に渡されていることをプロファイラーに通知し、スタックフレームと関数の引数に関する情報を提供します。 .NET Framework 4 で非推奨とされました。

FunctionLeave2 関数
関数が呼び出し元に戻ろうとしていることをプロファイラーに通知し、スタックフレームおよび関数の戻り値に関する情報を提供します。 .NET Framework 4 で非推奨とされました。

FunctionTailcall2 関数
現在実行中の関数によって別の関数の末尾呼び出しが実行されようとしていることをプロファイラーに通知し、スタックフレームに関する情報を提供します。 .NET Framework 4 で非推奨とされました。

StackSnapshotCallback 関数
 ICorProfilerInfo2::DoStackSnapshot メソッドによって開始されるスタックウォーク中に、スタック上の各マネージドフレームおよびアンマネージドフレームの各実行に関する情報がプロファイラーに提供されます。

.NET Framework バージョン 4 のプロファイリング関数

FunctionIDMapper2 関数
関数の特定の識別子が、FunctionEnter3、FunctionLeave3、および FunctionTailcall3、またはその関数の FunctionEnter3WithInfo、FunctionLeave3WithInfo、および FunctionTailcall3WithInfo の各コールバックで使用される代替 ID に再割り当てされることをプロファイラーに通知します。またこれにより、プロファイラーはその関数のコールバックを受信するかどうかを示すことができます。

FunctionIDMapper2 は、FunctionIDMapper 関数を clientData パラメーターで拡張します。プロファイラーは、これを使ってランタイム間のあいまいさを解決できます。

FunctionEnter3 関数
関数に制御が渡されていることをプロファイラーに通知します。

FunctionEnter3WithInfo 関数
関数に制御が渡されることをプロファイラーに通知し、スタックフレームと関数の引数を取得するために ICorProfilerInfo3::GetFunctionEnter3Info に渡すことができるハンドルを提供します。

FunctionLeave3 関数
関数から制御が戻されていることをプロファイラーに通知します。

FunctionLeave3WithInfo 関数
関数から制御が返されていることをプロファイラーに通知し、スタックフレームと戻り値を取得するために ICorProfilerInfo3::GetFunctionLeave3Info に渡すことができるハンドルを提供します。

FunctionTailcall3 関数
現在実行中の関数によって別の関数の末尾呼び出しが実行されようとしていることをプロファイラーに通知します。

FunctionTailcall3WithInfo 関数
現在実行中の関数によって別の関数の末尾呼び出しが実行されようとしていることをプロファイラーに通知し、スタックフレームを取得するために ICorProfilerInfo3::GetFunctionTailcall3Info に渡すことができるハンドルを提供します。