Compartir a través de


FunctionEnter (Función)

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

NotaNota

La función FunctionEnter está desusada en .NET Framework versión 2.0 y su uso repercutirá negativamente en el rendimiento.Utilice en su lugar la función FunctionEnter2.

void __stdcall FunctionEnter (
    [in]  FunctionID funcID
);

Parámetros

  • funcID
    [in] Identificador de la función a la que se pasa el control.

Comentarios

La función FunctionEnter 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 FunctionEnter no debe bloquearse porque retrasaría la recolección de elementos. 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, el motor en tiempo de ejecución se suspende hasta que se devuelva FunctionEnter

Asimismo, la función FunctionEnter no debe llamar a código administrado ni provocar de ninguna forma una asignación de memoria administrada.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: CorProf.idl

Biblioteca: CorGuids.lib

Versiones de .NET Framework: 1.1, 1.0

Vea también

Referencia

FunctionEnter2 (Función)

FunctionLeave2 (Función)

FunctionTailcall2 (Función)

ICorProfilerInfo2::SetEnterLeaveFunctionHooks2 (Método)

Otros recursos

Funciones estáticas globales para generación de perfiles

Historial de cambios

Fecha

Historial

Motivo

Octubre de 2010

Se agregó __stdcall a la sintaxis.

Comentarios de los clientes.