Metodo ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo

  • Articolo

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

Sintassi

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

Parametri

pFuncEnter3
[in] Puntatore all'implementazione da usare come FunctionEnter3WithInfo callback.

pFuncLeave3
[in] Puntatore all'implementazione da usare come FunctionLeave3WithInfo callback.

pFuncTailcall3
[in] Puntatore all'implementazione da usare come FunctionTailcall3WithInfo callback.

Commenti

Gli hook FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo forniscono l'ispezione dello stack frame e degli argomenti. Per accedere a tali informazioni, è necessario impostare i COR_PRF_ENABLE_FUNCTION_ARGSflag , COR_PRF_ENABLE_FUNCTION_RETVALe/o COR_PRF_ENABLE_FRAME_INFO . Il profiler può usare il metodo ICorProfilerInfo::SetEventMask per impostare i flag di evento e quindi usare il SetEnterLeaveFunctionHooks3WithInfo metodo per registrare l'implementazione di questa funzione.

Solo un set di callback può essere attivo alla volta e la versione più recente ha la precedenza. Pertanto, se un profiler chiama sia SetEnterLeaveFunctionHooks2 che SetEnterLeaveFunctionHooks3WithInfo, SetEnterLeaveFunctionHooks3WithInfo viene usato .

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

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile da 4

Vedi anche