FunctionEnter 関数

2008-09-17

更新 : 2007 年 11 月

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

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

void FunctionEnter (
        [in]  FunctionID funcID
);

パラメータ

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

解説

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

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

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

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

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