ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo (Método)

2011-08-10

Especifica las funciones implementadas por generador de perfiles a las que se llamarán en los enlaces FunctionEnter3WithInfo, FunctionLeave3WithInfo y FunctionTailcall3WithInfo de funciones administradas.

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

Parámetros

pFuncEnter3
[in] Puntero a la implementación que se va a utilizar como devolución de llamada de FunctionEnter3WithInfo.
pFuncLeave3
[in] Puntero a la implementación que se va a utilizar como devolución de llamada de FunctionLeave3WithInfo.
pFuncTailcall3
[in] Puntero a la implementación que se va a utilizar como devolución de llamada de FunctionTailcall3WithInfo.

Comentarios

Los enlaces FunctionEnter3WithInfo, FunctionLeave3WithInfo y FunctionTailcall3WithInfo 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 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 a SetEnterLeaveFunctionHooks2 y SetEnterLeaveFunctionHooks3WithInfo, se usa SetEnterLeaveFunctionHooks3WithInfo.

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