Método ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo

  • Artigo

Especifica as funções implementadas pelo criador de perfil que serão chamadas nos ganchos FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo de funções gerenciadas.

Sintaxe

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

Parâmetros

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

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

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

Comentários

Os ganchos FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo fornecem inspeção de quadro de pilha e argumento. Para acessar essas informações, os sinalizadores COR_PRF_ENABLE_FUNCTION_ARGS, COR_PRF_ENABLE_FUNCTION_RETVAL e/ou COR_PRF_ENABLE_FRAME_INFO devem ser definidos. O criador de perfil pode usar o método ICorProfilerInfo::SetEventMask para definir os sinalizadores de evento e, em seguida, usar o método SetEnterLeaveFunctionHooks3WithInfo para registrar sua implementação dessa função.

Apenas um conjunto de retornos de chamada pode estar ativo por vez e a versão mais recente tem precedência. Portanto, se um criador de perfil chamar SetEnterLeaveFunctionHooks2 e SetEnterLeaveFunctionHooks3WithInfo, SetEnterLeaveFunctionHooks3WithInfo será usado.

O método SetEnterLeaveFunctionHooks3WithInfo pode ser chamado somente do retorno de chamada ICorProfilerCallback::Initialize do criador de perfil.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4

Confira também