FunctionLeave2 関数

2008-09-17

更新 : 2007 年 11 月

関数が呼び出し元に戻る直前であることをプロファイラに通知し、スタックフレームと関数の戻り値に関する情報を提供します。

void FunctionLeave2 (
        [in]  FunctionID                        funcId,
        [in]  UINT_PTR                          clientData,
        [in]  COR_PRF_FRAME_INFO                func,
        [in]  COR_PRF_FUNCTION_ARGUMENT_RANGE  *retvalRange
);

パラメータ

funcId
[入力] 戻ろうとしている関数の ID。
clientData
[入力] 以前にプロファイラが FunctionIDMapper 関数で指定した、再マップされた関数 ID。
func
[入力] スタックフレームに関する情報を指す COR_PRF_FRAME_INFO 値。

プロファイラは、これを、ICorProfilerInfo2::GetFunctionInfo2 メソッドで実行エンジンに戻すことができる不透明ハンドルとして扱う必要があります。
retvalRange
[入力] 関数の戻り値のメモリ位置を指定する COR_PRF_FUNCTION_ARGUMENT_RANGE 構造体へのポインタ。

戻り値の情報にアクセスするには、COR_PRF_ENABLE_FUNCTION_RETVAL フラグを設定する必要があります。プロファイラは ICorProfilerInfo::SetEventMask メソッドを使用してイベントフラグを設定します。

解説

func パラメータおよび retvalRange パラメータの値は、FunctionLeave2 関数から制御が戻った後は、変更または破棄されている可能性があるため、有効ではありません。

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

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

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

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

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