ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo-Methode

Gibt die Profiler-implementierten Funktionen an, die für die Hooks verwalteter Funktionen FunctionEnter3WithInfo, FunctionLeave3WithInfo, und FunctionTailcall3WithInfo aufgerufen werden.

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

Parameter

pFuncEnter3
[in] Ein Zeiger auf die Implementierung, die als FunctionEnter3WithInfo-Rückruf verwendet werden soll.
pFuncLeave3
[in] Ein Zeiger auf die Implementierung, die als FunctionLeave3WithInfo-Rückruf verwendet werden soll.
pFuncTailcall3
[in] Ein Zeiger auf die Implementierung, die als FunctionTailcall3WithInfo-Rückruf verwendet werden soll.

Hinweise

Die Hooks FunctionEnter3WithInfo, FunctionLeave3WithInfo, and FunctionTailcall3WithInfo stellen Stapelrahmen und Argumentüberprüfung bereit. Um auf diese Informationen zuzugreifen, müssen die Flags COR_PRF_ENABLE_FUNCTION_ARGS, COR_PRF_ENABLE_FUNCTION_RETVAL und/oder COR_PRF_ENABLE_FRAME_INFO festgelegt werden. Der Profiler kann die Ereignisflags mithilfe der ICorProfilerInfo::SetEventMask-Methode festlegen und verwendet dann die SetEnterLeaveFunctionHooks3WithInfo-Methode, um die Implementierung dieser Funktion zu registrieren.

Nur ein Satz von Rückrufen kann gleichzeitig aktiv sein, und die neueste Version hat Vorrang. Wenn daher ein Profiler sowohl SetEnterLeaveFunctionHooks2 als auch SetEnterLeaveFunctionHooks3WithInfo aufruft, wird SetEnterLeaveFunctionHooks3WithInfo verwendet.

Die SetEnterLeaveFunctionHooks3WithInfo-Methode kann nur vom ICorProfilerCallback::Initialize-Rückruf des Profilers aufgerufen werden.