FunctionEnter2 (Función)

Artículo
08/10/2011

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

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 pasa el control.
clientData
[in] Identificador de la función reasignada, que el generador de perfiles especificó previamente mediante la función FunctionIDMapper.
func
[in] Valor COR_PRF_FRAME_INFO que señala a información acerca del marco de pila.

El generador de perfiles debe tratarlo como un identificador 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 que especifica las ubicaciones en memoria de los argumentos de la función.

Para tener acceso a la información del argumento, debe establecerse el marcador COR_PRF_ENABLE_FUNCTION_ARGS. El generador de perfiles puede utilizar el método ICorProfilerInfo::SetEventMask para establecer los marcadores de evento.

Comentarios

Los valores de los parámetros argumentInfo y func no son válidos una vez que vuelve la función FunctionEnter2, porque los valores pueden cambiar o destruirse.

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

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