FunctionLeave3 関数

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

更新 : 2010 年 10 月

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

void __stdcall FunctionLeave3(FunctionOrRemappedID functionOrRemappedID);

パラメーター

functionOrRemappedID
[入力] 制御が戻される関数の識別子。

解説

FunctionLeave3 コールバック関数は、関数が呼び出されることをプロファイラーに通知します。戻り値の検証は行いません。 ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 メソッドを使用して、この関数の実装を登録します。

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

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

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

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

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