Freigeben über

ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo-Methode

  • Artikel

Gibt die vom Profiler implementierten Funktionen an, die für die Hooks FunctionEnter3WithInfo, FunctionLeave3WithInfo und FunctionTailcall3WithInfo von verwalteten Funktionen aufgerufen werden.

Syntax

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.

Bemerkungen

Die Hooks FunctionEnter3WithInfo, FunctionLeave3WithInfo und FunctionTailcall3WithInfo bieten Stapelrahmen und Argumentüberprüfungen. 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 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 also ein Profiler sowohl SetEnterLeaveFunctionHooks2 als auch SetEnterLeaveFunctionHooks3WithInfo aufruft, wird SetEnterLeaveFunctionHooks3WithInfo verwendet.

Die SetEnterLeaveFunctionHooks3WithInfo-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

Weitere Informationen