FunctionTailcall3WithInfo 関数

[アーティクル]
08/09/2011

更新 : 2010 年 10 月

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

void __stdcall FunctionTailcall3WithInfo(
               [in] FunctionIDOrClientID functionIDOrClientID,
               [in] COR_PRF_ELT_INFO eltInfo);

パラメーター

functionIDOrClientID
[入力] tail 呼び出しを実行する直前である、現在実行中の関数の識別子。
eltInfo
[入力] 特定のスタックフレームに関する情報を表す不透明ハンドル。このハンドルは、ハンドルが渡されるコールバック内でのみ有効です。

解説

FunctionTailcall3WithInfo コールバックメソッドは、関数としてのプロファイラーが呼び出されたことを通知します。プロファイラーは ICorProfilerInfo3::GetFunctionTailcall3Info メソッドを使用してスタックフレームを調べることができるようになります。スタックフレームの情報にアクセスするには、COR_PRF_ENABLE_FRAME_INFO フラグを設定する必要があります。プロファイラーはイベントフラグを設定するために ICorProfilerInfo::SetEventMask メソッドを使用できます。また、この関数の実装を登録するために ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo メソッドを使用できます。

FunctionTailcall3WithInfo 関数はコールバックですが、ユーザー自身で実装する必要があります。実装では、__declspec(naked) ストレージクラス属性を使用する必要があります。

この関数を呼び出すまで、実行エンジンはどのレジスタも保存しません。

エントリ時に、使用するすべてのレジスタを、浮動小数点ユニット (FPU: Floating-Point Unit) のレジスタも含めて保存する必要があります。
終了時に、呼び出し元によってプッシュされたすべてのパラメーターをポップすることで、スタックを復元する必要があります。

ガベージコレクションが遅延するので、FunctionTailcall3WithInfo の実装ではブロックを行わないでください。スタックがガベージコレクションできる状態とは限らないので、実装ではガベージコレクションを実行しないでください。ガベージコレクションが試行された場合、ランタイムは、FunctionTailcall3WithInfo が戻るまでブロックを行います。

さらに、FunctionTailcall3WithInfo 関数では、マネージコードを呼び出さないようにする必要があります。呼び出すと、マネージメモリの割り当てが実行されます。