FunctionEnter 関数

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

更新 : 2010 年 10 月

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

メモ
FunctionEnter 関数は、.NET Framework Version 2.0 では推奨されておらず、これを使用するとパフォーマンスが低下します。代わりに、FunctionEnter2 関数を使用してください。

void __stdcall FunctionEnter (
    [in]  FunctionID funcID
);

パラメーター

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

解説

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

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

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

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

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