Método de ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo

Artigo
08/08/2011

Especifica as funções implementadas o profiler que serão chamadas na FunctionEnter3WithInfo, FunctionLeave3WithInfo, e FunctionTailcall3WithInfo ganchos de funções gerenciadas.

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

Parâmetros

pFuncEnter3
[in] Um ponteiro para a implementação a ser usado como o FunctionEnter3WithInfo retorno de chamada.
pFuncLeave3
[in] Um ponteiro para a implementação a ser usado como o FunctionLeave3WithInfo retorno de chamada.
pFuncTailcall3
[in] Um ponteiro para a implementação a ser usado como o FunctionTailcall3WithInfo retorno de chamada.

Comentários

O FunctionEnter3WithInfo, FunctionLeave3WithInfo, e FunctionTailcall3WithInfo ganchos fornecem a inspeção de quadro e o argumento da pilha. Para acessar essas informações, o COR_PRF_ENABLE_FUNCTION_ARGS, COR_PRF_ENABLE_FUNCTION_RETVAL, e/ou COR_PRF_ENABLE_FRAME_INFO sinalizadores precisam ser definido. O profiler pode usar o ICorProfilerInfo::SetEventMask método para definir os sinalizadores de evento e, em seguida, use o SetEnterLeaveFunctionHooks3WithInfo método para registrar a sua implementação desta função.

Apenas um conjunto de retornos de chamada pode estar ativo ao mesmo tempo, e a versão mais recente terá precedência. Portanto, se um gerador de perfil chama ambos SetEnterLeaveFunctionHooks2 e SetEnterLeaveFunctionHooks3WithInfo, SetEnterLeaveFunctionHooks3WithInfo é usado.

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