Partilhar via

Método ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo

  • Artigo

Especifica as funções implementadas pelo profiler que serão chamadas nos hooks FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo das funções geridas.

Sintaxe

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

Parâmetros

pFuncEnter3
[in] Um ponteiro para a implementação a utilizar como chamada FunctionEnter3WithInfo de retorno.

pFuncLeave3
[in] Um ponteiro para a implementação a utilizar como chamada FunctionLeave3WithInfo de retorno.

pFuncTailcall3
[in] Um ponteiro para a implementação a utilizar como chamada FunctionTailcall3WithInfo de retorno.

Observações

Os ganchos FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo fornecem a moldura da pilha e a inspeção de argumentos. Para aceder a essas informações, os COR_PRF_ENABLE_FUNCTION_ARGSsinalizadores , COR_PRF_ENABLE_FUNCTION_RETVALe/ou COR_PRF_ENABLE_FRAME_INFO têm de ser definidos. O profiler pode utilizar o método ICorProfilerInfo::SetEventMask para definir os sinalizadores de eventos e, em seguida, utilizar o SetEnterLeaveFunctionHooks3WithInfo método para registar a implementação desta função.

Apenas um conjunto de chamadas de retorno pode estar ativo de cada vez e a versão mais recente tem precedência. Por conseguinte, se um gerador de perfis chamar SetEnterLeaveFunctionHooks2 e SetEnterLeaveFunctionHooks3WithInfo, SetEnterLeaveFunctionHooks3WithInfo é utilizado.

O SetEnterLeaveFunctionHooks3WithInfo método pode ser chamado apenas a partir de ICorProfilerCallback::Initialize callback do profiler.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

.NET Framework Versões: Disponível desde 4

Ver também