Compartir a través de


FunctionLeave3 (Función)

Esta función puede usarse para notificar al generador de perfiles de que va a devolver el control a una función.

Sintaxis

void __stdcall FunctionLeave3(FunctionOrRemappedID functionOrRemappedID);  

Parámetros

functionOrRemappedID [in] Identificador de la función desde la que se devolverá el control.

Comentarios

La función FunctionLeave3 de devolución de llamada notifica al generador de perfiles a medida que se llama a las funciones, pero no admite la inspección de valores devueltos. Use el método ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 para registrar la implementación de esta función.

La función FunctionLeave3 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 FunctionLeave3 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 FunctionLeave3 devuelva un valor.

La función FunctionLeave3 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

Consulte también