ICorProfilerInfo3::SetEnterLeaveFunctionHooks3-Methode
Gibt die vom Profiler implementierten Funktionen an, die für die Funktionen FunctionEnter3, FunctionLeave3 und FunctionTailcall3 aufgerufen werden.
Syntax
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.
Bemerkungen
Die Hooks FunctionEnter3, FunctionLeave3 und FunctionTailcall3 bieten keine Stapelrahmen- und Argumentüberprüfung. 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 ICorProfilerInfo::SetEventMask-Methode verwenden, um die Ereignisflags festzulegen, und dann die ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo-Methode verwenden, um Ihre Implementierung dieser Funktion zu registrieren.
Es kann jeweils nur eine Gruppe von Rückrufen aktiv sein, und die neueste Version hat Vorrang. Wenn ein Profiler daher sowohl die SetEnterLeaveFunctionHooks2-Methode als auch die SetEnterLeaveFunctionHooks3-Methode aufruft, SetEnterLeaveFunctionHooks3 wird verwendet.
Die SetEnterLeaveFunctionHooks3-Methode kann nur über den ICorProfilerCallback::Initialize-Rückruf des Profilers aufgerufen werden.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: CorProf.idl, CorProf.h
Bibliothek: CorGuids.lib
.NET Framework-Versionen: Seit Version 4 verfügbar.
