FunctionLeave3 (Función)

Artículo
08/10/2011

Notifica al generador de perfiles que se está devolviendo el control de una función.

void __stdcall FunctionLeave3(FunctionOrRemappedID functionOrRemappedID);

Parámetros

functionOrRemappedID
[in] Identificador de la función de la que se devuelve el control.

Comentarios

La función de devolución de llamada FunctionLeave3 notifica al generador de perfiles cuando se está llamando a las funciones, pero no admite la inspección del valor devuelto. Use el método ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 para registrar su implementación de esta función.

La función FunctionLeave3 es una devolución de llamada; debe implementarla. La implementación debe utilizar el atributo de clase de almacenamiento __declspec(naked).

El motor de ejecución no guarda ningún registro antes de llamar a esta función.

En la entrada, debe guardar todos los registros que utilice, incluidos los de la unidad de punto flotante (FPU).
Al salir, debe restablecer la pila desactivando todos los parámetros insertados por el llamador.

La implementación de FunctionLeave3 no debe bloquearse porque retrasaría la recolección de elementos no utilizados. La implementación no debería intentar realizar la recolección de elementos no utilizados porque es posible que la pila no esté en un estado adecuado para ello. Si se intenta realizar una recolección de elementos no utilizados, el motor en tiempo de ejecución se bloqueará hasta que se devuelva FunctionLeave3

La función FunctionLeave3 no debe llamar a código administrado ni provocar una asignación de memoria administrada de ninguna forma.