次の方法で共有

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

参照

参照

FunctionEnter2 関数

FunctionLeave2 関数

ICorProfilerInfo2::SetEnterLeaveFunctionHooks2 メソッド

その他の技術情報

グローバル静的関数のプロファイル

履歴の変更

日付

履歴

理由

2010 年 10 月

__stdcall を構文に追加。

カスタマー フィードバック