FunctionTailcall2 関数
更新 : 2010 年 10 月
現在実行中の関数が、別の関数への tail 呼び出しを実行する直前であることをプロファイラーに通知し、スタック フレームに関する情報を提供します。
void __stdcall FunctionTailcall2 (
[in] FunctionID funcId,
[in] UINT_PTR clientData,
[in] COR_PRF_FRAME_INFO func
);
パラメーター
funcId
[入力] tail 呼び出しを実行する直前である、現在実行中の関数の識別子。clientData
[入力] tail 呼び出しを実行する直前である現在実行中の関数の、再マップされた関数識別子。この識別子は、以前にプロファイラーが FunctionIDMapper で指定したものです。func
[入力] スタック フレームに関する情報を指す COR_PRF_FRAME_INFO 値。プロファイラーは、これを、ICorProfilerInfo2::GetFunctionInfo2 メソッドで実行エンジンに戻すことができる不透明ハンドルとして扱う必要があります。
解説
tail 呼び出しの対象の関数は現在のスタック フレームを使用し、tail 呼び出しを行った関数の呼び出し元に直接戻ります。 つまり、tail 呼び出しの対象である関数では、FunctionLeave2 コールバックは発行されません。
func パラメーターの値は、FunctionTailcall2 関数から制御が戻った後は、変更または破棄されている可能性があるため、有効ではありません。
FunctionTailcall2 関数はコールバックですが、ユーザー自身で実装する必要があります。 実装では、__declspec(naked) ストレージ クラス属性を使用する必要があります。
この関数を呼び出すまで、実行エンジンはどのレジスタも保存しません。
エントリ時に、使用するすべてのレジスタを、浮動小数点ユニット (FPU: Floating-Point Unit) のレジスタも含めて保存する必要があります。
終了時に、呼び出し元によってプッシュされたすべてのパラメーターをポップすることで、スタックを復元する必要があります。
ガベージ コレクションが遅延するので、FunctionTailcall2 の実装ではブロックを行わないでください。 スタックがガベージ コレクションできる状態とは限らないので、実装ではガベージ コレクションを実行しないでください。 ガベージ コレクションが試行された場合、ランタイムは、FunctionTailcall2 が戻るまでブロックを行います。
さらに、FunctionTailcall2 関数では、マネージ コードを呼び出さないようにする必要があります。呼び出すと、マネージ メモリの割り当てが実行されます。
必要条件
プラットフォーム : 「.NET Framework システム要件」を参照
ヘッダー: CorProf.idl
ライブラリ: CorGuids.lib
.NET Framework のバージョン: 4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0
参照
参照
ICorProfilerInfo2::SetEnterLeaveFunctionHooks2 メソッド
その他の技術情報
履歴の変更
日付 |
履歴 |
理由 |
---|---|---|
2010 年 10 月 |
__stdcall を構文に追加。 |
カスタマー フィードバック |