FunctionTailcall2 関数

2008-09-17

更新 : 2007 年 11 月

現在実行中の関数が、別の関数への tail 呼び出しを実行する直前であることをプロファイラに通知し、スタックフレームに関する情報を提供します。

void 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) のレジスタも含めて保存する必要があります。
終了時に、呼び出し元によってプッシュされたすべてのパラメータをポップすることで、スタックを復元する必要があります。

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

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