ICorProfilerInfo3::SetEnterLeaveFunctionHooks3-Methode

Artikel
08/10/2011

Gibt die Profiler-implementierten Funktionen an, die für die Funktionen FunctionEnter3, FunctionLeave3 und FunctionTailcall3 aufgerufen werden.

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

Parameter

pFuncEnter3
[in] Ein Zeiger auf die Implementierung, die als FunctionEnter3-Rückruf verwendet werden soll.
pFuncLeave3
[in] Ein Zeiger auf die Implementierung, die als FunctionLeave3-Rückruf verwendet werden soll.
pFuncTailcall3
[in] Ein Zeiger auf die Implementierung, die als FunctionTailcall3-Rückruf verwendet werden soll.

Hinweise

Die Hooks FunctionEnter3, FunctionLeave3, und FunctionTailcall3 stellen keinen 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 ICorProfilerInfo3::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 den ICorProfilerInfo2::SetEnterLeaveFunctionHooks2-Methode und die SetEnterLeaveFunctionHooks3-Methode aufruft, wird SetEnterLeaveFunctionHooks3 verwendet.

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