FunctionLeave3WithInfo (Función)
Notifica al generador de perfiles que se devuelve el control de una función y proporciona un identificador que se puede pasar al método ICorProfilerInfo3::GetFunctionLeave3Info para recuperar el marco de pila y el valor devuelto.
Sintaxis
void __stdcall FunctionLeave3WithInfo(
[in] FunctionIDOrClientID functionIDOrClientID,
[in] COR_PRF_ELT_INFO eltInfo);
Parámetros
functionIDOrClientID [in] Identificador de la función desde la que se devolverá el control.
eltInfo [in] Controlador opaco que representa información sobre un marco de pila determinado. Este controlador es válido solo durante la devolución de llamada a la que se pasa.
Comentarios
El método de devolución de llamada de FunctionLeave3WithInfo notifica al generador de perfiles mientras se llama a las funciones y permite al generador de perfiles usar el método ICorProfilerInfo3::GetFunctionLeave3Info para inspeccionar el valor devuelto. Para obtener acceso a la información del valor devuelto, se deberá establecer la marca COR_PRF_ENABLE_FUNCTION_RETVAL. El generador de perfiles puede usarse con el método ICorProfilerInfo::SetEventMask para establecer las marcas de evento y, después, con el método ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo para registrar la implementación de esta función.
La función FunctionLeave3WithInfo es una devolución de llamada y, como tal, debe implementarse. La implementación debe usar el atributo __declspec(naked) de las clases de almacenamiento.
El motor de ejecución no guarda ningún registro antes de que se llame a esta función.
En el proceso de entrada de la función, deberá guardar todos los registros que use, incluidos los de la unidad de punto flotante (FPU).
En el proceso de salida, deberá quitar todos los parámetros que haya insertado su autor de la llamada para restaurar la pila.
La implementación de la función FunctionLeave3WithInfo no debe bloquearse, ya que esto producirá retrasos en los procesos de recolección de elementos no utilizados. En la implementación, no deberá intentarse realizar un proceso de recolección de elementos no utilizados, ya que es posible que la pila esté en un estado en el que este no se pueda realizar. Si se intenta realizar un proceso de recolección de elementos no utilizados, el runtime se bloqueará hasta que FunctionLeave3WithInfo devuelva un valor.
La función FunctionLeave3WithInfo no deberá usarse para realizar llamadas a código administrado ni para provocar una asignación de memoria administrada de cualquier manera.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: CorProf.idl
Biblioteca: CorGuids.lib
Versiones de .NET Framework: disponible a partir de la versión 4
