Compartir a través de

FunctionEnter3WithInfo (Función)

  • Artículo

Notifica al generador de perfiles que se pasa el control a una función y proporciona un identificador que se puede pasar al método ICorProfilerInfo3::GetFunctionEnter3Info para recuperar el marco de pila y los argumentos de función.

Sintaxis

void __stdcall FunctionEnter3WithInfo(  
               [in] FunctionIDOrClientID functionIDOrClientID,  
               [in] COR_PRF_ELT_INFO eltInfo);

Parámetros

functionIDOrClientID [in] Identificador de la función a la que se pasará 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 FunctionEnter3WithInfo notifica al generador de perfiles mientras se llama a las funciones y permite al generador de perfiles usar el método ICorProfilerInfo3::GetFunctionEnter3Info para inspeccionar los valores de argumento. Para acceder a la información del argumento, se debe establecer la marca COR_PRF_ENABLE_FUNCTION_ARGS. 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 FunctionEnter3WithInfo 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 FunctionEnter3WithInfo 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 FunctionEnter3WithInfo devuelva un valor.

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

Consulte también