ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo 方法

發行項
08/12/2011

更新：2010 年 10 月

指定程式碼剖析工具實作函式，這些將會在 Managed 函式的 FunctionEnter3WithInfo、FunctionLeave3WithInfo 和 FunctionTailcall3WithInfo 攔截程序中呼叫。

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

參數

pFuncEnter3
[in] 實作的指標，被用來當做 FunctionEnter3WithInfo 回呼。
pFuncLeave3
[in] 實作的指標，被用來當做 FunctionLeave3WithInfo 回呼。
pFuncTailcall3
[in] 實作的指標，被用來當做 FunctionTailcall3WithInfo 回呼。

備註

FunctionEnter3WithInfo、FunctionLeave3WithInfo 和 FunctionTailcall3WithInfo 攔截程序會提供堆疊框架和引數檢查。若要存取該資訊，就必須設定 COR_PRF_ENABLE_FUNCTION_ARGS、COR_PRF_ENABLE_FUNCTION_RETVAL 和 (或) COR_PRF_ENABLE_FRAME_INFO旗標。分析工具可使用 ICorProfilerInfo::SetEventMask 方法來設定事件旗標，然後使用 SetEnterLeaveFunctionHooks3WithInfo 方法來註冊您對這個函式的實作。

同時只有一組回呼可在作用中，而且最新版本會取得優先。因此，如果分析工具呼叫 SetEnterLeaveFunctionHooks2 和 SetEnterLeaveFunctionHooks3WithInfo 兩者，就會使用 SetEnterLeaveFunctionHooks3WithInfo。

SetEnterLeaveFunctionHooks3WithInfo 方法可能只能從分析工具的 ICorProfilerCallback::Initialize 回呼中進行呼叫。