Compartir a través de

FunctionEnter2 (Función)

  • Artículo

Notifica al generador de perfiles que el control se pasa a una función y proporciona información sobre el marco de pila y los argumentos de función. Esta función reemplaza a FunctionEnter.

Sintaxis

void __stdcall FunctionEnter2 (  
    [in]  FunctionID                       funcId,
    [in]  UINT_PTR                         clientData,
    [in]  COR_PRF_FRAME_INFO               func,
    [in]  COR_PRF_FUNCTION_ARGUMENT_INFO  *argumentInfo  
);

Parámetros

funcId [in] Identificador de la función a la que se pasará el control.

clientData [in] Identificador reasignado de la función que se especificó anteriormente en el generador de perfiles mediante la función FunctionIDMapper.

func [in] El valor COR_PRF_FRAME_INFO de este parámetro se usa para apuntar a la información sobre el marco de pila.

El generador de perfiles debe tratar este valor como si fuese un manipulador opaco que se puede devolver al motor de ejecución en el método ICorProfilerInfo2::GetFunctionInfo2.

argumentInfo [in] Puntero a una estructura COR_PRF_FUNCTION_ARGUMENT_INFO, donde se especifica las ubicaciones en memoria de los argumentos de la función.

Para acceder a la información del argumento, se deberá establecer la marca COR_PRF_ENABLE_FUNCTION_ARGS. Para establecer las marcas de evento, puede usarse el método ICorProfilerInfo::SetEventMask en el generador de perfiles.

Comentarios

Los valores de los parámetros func y argumentInfo no serán válidos una vez que la función FunctionEnter2 se devuelva, ya que puede que estos cambien o se destruyan.

La función FunctionEnter2 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 llamador para restaurar la pila.

La implementación de la función FunctionEnter2 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 tiempo de ejecución se bloqueará hasta que se devuelva la función FunctionEnter2.

Además, la función FunctionEnter2 no deberá usarse para realizar llamadas a código administrado ni para provocar una asignación de memoria administrada sin importar el motivo.

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