Metodo ICorProfilerInfo3::SetEnterLeaveFunctionHooks3

Articolo
08/11/2011

Specifica le funzioni implementate dal profiler che verranno chiamate sulle funzioni FunctionEnter3, FunctionLeave3 e FunctionTailcall3.

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

Parametri

pFuncEnter3
[in] Puntatore all'implementazione da utilizzare come callback di FunctionEnter3.
pFuncLeave3
[in] Puntatore all'implementazione da utilizzare come callback di FunctionLeave3.
pFuncTailcall3
[in] Puntatore all'implementazione da utilizzare come callback di FunctionTailcall3.

Note

Gli hook FunctionEnter3, FunctionLeave3 e FunctionTailcall3 non forniscono stack frame né l'esame degli argomenti. Per accedere a tali informazioni devono essere impostati i flag COR_PRF_ENABLE_FUNCTION_ARGS, COR_PRF_ENABLE_FUNCTION_RETVAL e/o COR_PRF_ENABLE_FRAME_INFO. Il profiler può utilizzare prima il metodo ICorProfilerInfo::SetEventMask per impostare i flag dell'evento e quindi il metodo ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo per registrare l'implementazione di questa funzione.

Solo un set di callback per volta può essere attivo e la versione più nuova ha la precedenza. Pertanto, se un profiler chiama sia Metodo ICorProfilerInfo2::SetEnterLeaveFunctionHooks2 sia il metodo SetEnterLeaveFunctionHooks3, il sistema utilizza SetEnterLeaveFunctionHooks3.

Il metodo SetEnterLeaveFunctionHooks3 può essere chiamato solo dal callback di ICorProfilerCallback::Initialize del profiler.