FunctionTailcall3 関数

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

更新 : 2010 年 10 月

現在実行中の関数が、別の関数への tail 呼び出しを実行する直前であることを、プロファイラーに通知します。

void __stdcall FunctionTailcall3 (FunctionOrRemappedID functionOrRemappedID);

パラメーター

functionOrRemappedID
[入力] tail 呼び出しを実行する直前である、現在実行中の関数の識別子。

解説

FunctionTailcall3 コールバック関数は、関数が呼び出されるときにプロファイラーに通知します。 ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 メソッドを使用して、この関数の実装を登録します。

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

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

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

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

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