Udostępnij za pośrednictwem

ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo — Metoda

  • Artykuł

Określa funkcje implementowane przez profiler, które będą wywoływane w elementach FunctionEnter3WithInfo, FunctionLeave3WithInfo i FunctionTailcall3WithInfo funkcji zarządzanych.

Składnia

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

Parametry

pFuncEnter3
[in] Wskaźnik do implementacji, który ma być używany jako wywołanie FunctionEnter3WithInfo zwrotne.

pFuncLeave3
[in] Wskaźnik do implementacji, który ma być używany jako wywołanie FunctionLeave3WithInfo zwrotne.

pFuncTailcall3
[in] Wskaźnik do implementacji, który ma być używany jako wywołanie FunctionTailcall3WithInfo zwrotne.

Uwagi

Punkty zaczepienia FunctionEnter3WithInfo, FunctionLeave3WithInfo i FunctionTailcall3WithInfo zapewniają kontrolę ramki stosu i argumentów. Aby uzyskać dostęp do tych informacji, COR_PRF_ENABLE_FUNCTION_ARGSnależy ustawić flagi , COR_PRF_ENABLE_FUNCTION_RETVALi/lub COR_PRF_ENABLE_FRAME_INFO . Profiler może użyć metody ICorProfilerInfo::SetEventMask , aby ustawić flagi zdarzeń, a następnie użyć SetEnterLeaveFunctionHooks3WithInfo metody do zarejestrowania implementacji tej funkcji.

Jednocześnie może być aktywny tylko jeden zestaw wywołań zwrotnych, a najnowsza wersja ma pierwszeństwo. W związku z tym, jeśli profiler wywołuje zarówno SetEnterLeaveFunctionHooks2 , jak i SetEnterLeaveFunctionHooks3WithInfo, SetEnterLeaveFunctionHooks3WithInfo jest używany.

Metoda SetEnterLeaveFunctionHooks3WithInfo może być wywoływana tylko z wywołania zwrotnego ICorProfilerCallback::Initialize profilera.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorProf.idl, CorProf.h

Biblioteki: CorGuids.lib

wersje .NET Framework: dostępne od 4

Zobacz też