FunctionLeave 関数

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

更新 : 2010 年 10 月

関数が呼び出し元に戻ろうとしていることをプロファイラーに通知します。

メモ
FunctionLeave 関数は、.NET Framework 2.0 での使用は推奨されていません。機能はしますが、パフォーマンスが低下します。代わりに、FunctionLeave2 関数を使用してください。

void __stdcall FunctionLeave (
    [in] FunctionID funcID
);

パラメーター

funcID
[入力] 戻ろうとしている関数の識別子。

解説

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

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

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

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

さらに、FunctionLeave 関数では、マネージコードを呼び出したり、マネージメモリの割り当てが行われるような処理を実行したりすることは避ける必要があります。