Share via

FunctionTailcall2 関数

  • [アーティクル]

現在実行中の関数によって別の関数の末尾呼び出しが実行されようとしていることをプロファイラーに通知し、スタック フレームに関する情報を提供します。

構文

void __stdcall FunctionTailcall2 (  
    [in] FunctionID         funcId,
    [in] UINT_PTR           clientData,
    [in] COR_PRF_FRAME_INFO func  
);

パラメーター

funcId [in] 末尾呼び出しを実行しようとしている現在実行中の関数の識別子。

clientData [in] 末尾呼び出しを実行しようとしている現在実行中の関数の、プロファイラーが以前 FunctionIDMapper を使用して指定した、再マップされた関数識別子。

func [in] スタック フレームに関する情報をポイントする COR_PRF_FRAME_INFO 値。

プロファイラーではこれを ICorProfilerInfo2::GetFunctionInfo2 メソッドの実行エンジンに渡すことができる不透明なハンドルとして処理する必要があります。

解説

末尾呼び出しの対象の関数では現在のスタックフレームが使用され、末尾呼び出しを行った関数の呼び出し元に直接戻ります。 つまり、FunctionLeave2 コールバックは、末尾呼び出しの対象である関数に対しては発行されません。

値が変更または破棄される可能性があるため、FunctionTailcall2 関数が制御を返すと func パラメーターの値が無効になります。

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

この関数を呼び出す前に、実行エンジンではレジスタは保存されません。

  • 開始時には、浮動小数点演算ユニット (FPU) 内のものを含め、使用するすべてのレジスタを保存する必要があります。

  • 終了時には、呼び出し元によってプッシュされたすべてのパラメーターをポップして、スタックを復元する必要があります。

FunctionTailcall2 の実装では、ガベージ コレクションが遅れるためブロックしないでください。 スタックがガベージ コレクション対応状態ではない可能性があるため、この実装ではガベージ コレクションを試行しないでください。 ガベージ コレクションが試行された場合、FunctionTailcall2 が返されるまでランタイムはブロックされます。

また、FunctionTailcall2 関数では、マネージド コードを呼び出すことはできません。呼び出すと、何らかのマネージド メモリ割り当てが行われます。

要件

:「システム要件」を参照してください。

ヘッダー: CorProf.idl

ライブラリ: CorGuids.lib

.NET Framework のバージョン: 2.0 以降で使用可能

関連項目