ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo メソッド

[アーティクル]
08/09/2011

更新 : 2010 年 10 月

マネージ関数の FunctionEnter3WithInfo フック、FunctionLeave3WithInfo フック、および FunctionTailcall3WithInfo フックで呼び出されるプロファイラー実装関数を指定します。

HRESULT SetEnterLeaveFunctionHooks3WithInfo(
            [in] FunctionEnter3WithInfo    *pFuncEnter3,
            [in] FunctionLeave3withInfo    *pFuncLeave3,
            [in] FunctionTailcall3WithInfo *pFuncTailcall3);

パラメーター

pFuncEnter3
[入力] FunctionEnter3WithInfo コールバックとして使用される実装へのポインター。
pFuncLeave3
[入力] FunctionLeave3WithInfo コールバックとして使用される実装へのポインター。
pFuncTailcall3
[入力] FunctionTailcall3WithInfo コールバックとして使用される実装へのポインター。

解説

FunctionEnter3WithInfo、FunctionLeave3WithInfo、および FunctionTailcall3WithInfo の各フックには、スタックフレームと引数の検査が用意されています。この情報にアクセスするには、COR_PRF_ENABLE_FUNCTION_ARGS、COR_PRF_ENABLE_FUNCTION_RETVAL、および COR_PRF_ENABLE_FRAME_INFO の各フラグについて、すべてまたはいずれかを設定する必要があります。プロファイラーは ICorProfilerInfo::SetEventMask メソッドを使用してイベントフラグを設定してから、SetEnterLeaveFunctionHooks3WithInfo メソッドを使用してこの関数の実装を登録します。

同時にアクティブ化できるのは 1 組のコールバックのみです。最新バージョンが優先されます。したがって、プロファイラーが SetEnterLeaveFunctionHooks2 および SetEnterLeaveFunctionHooks3WithInfo の両方を呼び出すと、SetEnterLeaveFunctionHooks3WithInfo が使用されます。

SetEnterLeaveFunctionHooks3WithInfo メソッドを呼び出すことができるのは、プロファイラーの ICorProfilerCallback::Initialize コールバックだけです。