FunctionEnter2 (Función)
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