Método ICorProfilerInfo3::SetEnterLeaveFunctionHooks3

  • Artigo

Especifica as funções implementadas pelo criador de perfil que serão chamadas nas funções FunctionEnter3, FunctionLeave3 e FunctionTailcall3.

Sintaxe

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

Parâmetros

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

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

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

Comentários

Os ganchos FunctionEnter3, FunctionLeave3 e FunctionTailcall3 não fornecem inspeção de registro de ativação 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 ICorProfilerInfo3::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 o Método SetEnterLeaveFunctionHooks2 e o métodoSetEnterLeaveFunctionHooks3, SetEnterLeaveFunctionHooks3 será usado.

O método SetEnterLeaveFunctionHooks3 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