ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 (Método)

Artículo
08/10/2011

Especifica las funciones implementadas por generador de perfiles a las que se llamarán en las funciones FunctionEnter3, FunctionLeave3 y FunctionTailcall3.

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

Parámetros

pFuncEnter3
[in] Puntero a la implementación que se va a utilizar como devolución de llamada de FunctionEnter3.
pFuncLeave3
[in] Puntero a la implementación que se va a utilizar como devolución de llamada de FunctionLeave3.
pFuncTailcall3
[in] Puntero a la implementación que se va a utilizar como devolución de llamada de FunctionTailcall3.

Comentarios

Los enlaces FunctionEnter3, FunctionLeave3 y de FunctionTailcall3 no proporcionan marco de pila e inspección de argumento. Para tener acceso a esa información, las marcas COR_PRF_ENABLE_FUNCTION_ARGS, COR_PRF_ENABLE_FUNCTION_RETVAL y/o COR_PRF_ENABLE_FRAME_INFO tienen que estar establecidas. El generador de perfiles puede usar el método ICorProfilerInfo::SetEventMask para establecer las marcas de evento y, a continuación, usar el método ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo para registrar su implementación de esta función.

Solo un conjunto de devoluciones de llamada puede estar activo en un momento y la versión más reciente tiene prioridad. Por consiguiente, si un generador de perfiles llama al método ICorProfilerInfo2::SetEnterLeaveFunctionHooks2 (Método) y SetEnterLeaveFunctionHooks3, se usa SetEnterLeaveFunctionHooks3.

Sólo se puede llamar al método SetEnterLeaveFunctionHooks3 desde la devolución de llamada de ICorProfilerCallback::Initialize del generador de perfiles.