Método de ICorProfilerInfo3::SetEnterLeaveFunctionHooks3

Artigo
08/08/2011

Especifica as funções implementadas o profiler que serão chamadas na FunctionEnter3, FunctionLeave3, e FunctionTailcall3 funções.

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

Parâmetros

pFuncEnter3
[in] Um ponteiro para a implementação a ser usado como o FunctionEnter3 retorno de chamada.
pFuncLeave3
[in] Um ponteiro para a implementação a ser usado como o FunctionLeave3 retorno de chamada.
pFuncTailcall3
[in] Um ponteiro para a implementação a ser usado como o FunctionTailcall3 retorno de chamada.

Comentários

FunctionEnter3, FunctionLeave3, e FunctionTailcall3 ganchos não 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 ICorProfilerInfo3::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 os Método de ICorProfilerInfo2::SetEnterLeaveFunctionHooks2 e o SetEnterLeaveFunctionHooks3 método, SetEnterLeaveFunctionHooks3 é usado.

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