FunctionLeave 関数

2008-09-17

更新 : 2007 年 11 月

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

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

void FunctionLeave (
        [in] FunctionID funcID
);

パラメータ

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

解説

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

この関数を呼び出す前に、実行エンジンがレジスタを保存することはありません。

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

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

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