Metodo ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo

Articolo
08/11/2011

Specifica le funzioni implementate dal profiler che verranno chiamate sugli hook FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo di funzioni gestite.

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

Parametri

pFuncEnter3
[in] Puntatore all'implementazione da utilizzare come callback di FunctionEnter3WithInfo.
pFuncLeave3
[in] Puntatore all'implementazione da utilizzare come callback di FunctionLeave3WithInfo.
pFuncTailcall3
[in] Puntatore all'implementazione da utilizzare come callback di FunctionTailcall3WithInfo.

Note

Gli hook FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo forniscono stack frame nonché 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 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 SetEnterLeaveFunctionHooks2 sia SetEnterLeaveFunctionHooks3WithInfo, il sistema utilizza SetEnterLeaveFunctionHooks3WithInfo.

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