ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 メソッド

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

FunctionEnter3、FunctionLeave3、および FunctionTailcall3 の各関数で呼び出されるプロファイラー実装関数を指定します。

HRESULT SetEnterLeaveFunctionHooks3(
            [in] FunctionEnter3    *pFuncEnter3,
            [in] FunctionLeave3    *pFuncLeave3,
            [in] FunctionTailcall3 *pFuncTailcall3);

パラメーター

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

解説

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

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

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