ICorProfilerInfo3 (Interfaz)

Artículo
08/10/2011

Proporciona métodos que los generadores de perfiles de código usan para comunicarse con Common Language Runtime (CLR) con el fin de controlar la supervisión de eventos y solicitar información. La interfaz ICorProfilerInfo3 es una extensión de la interfaz ICorProfilerInfo2. Proporciona nuevos métodos admitidos en .NET Framework versión 4 y en versiones posteriores.

Métodos

Método	Descripción
ICorProfilerInfo3::EnumJITedFunctions (Método)	Devuelve un enumerador para todas las funciones compiladas por JIT previamente.
ICorProfilerInfo3::EnumModules (Método)	Devuelve un enumerador que proporciona métodos para recorrer en iteración secuencialmente una colección de módulos administrados cargados en la aplicación.
ICorProfilerInfo3::GetAppDomainsContainingModule (Método)	Obtiene los identificadores de los dominios de aplicación en los que se ha cargado el módulo dado.
ICorProfilerInfo3::GetFunctionEnter3Info (Método)	Proporciona la información de marco de pila y argumentos de la función que se notifica al generador de perfiles mediante la función FunctionEnter3WithInfo; únicamente se puede llamar durante la devolución de llamada FunctionEnter3WithInfo.
ICorProfilerInfo3::GetFunctionLeave3Info (Método)	Proporciona el marco de pila y valor devuelto de la función que se notifica al generador de perfiles mediante la función FunctionEnter3WithInfo (Función); únicamente se puede llamar durante la devolución de llamada FunctionLeave3WithInfo.
ICorProfilerInfo3::GetFunctionTailcall3Info (Método)	Proporciona el marco de pila de la función que se notifica al generador de perfiles mediante la función FunctionTailcall3WithInfo; únicamente se puede llamar durante la devolución de llamada FunctionTailcall3WithInfo.
ICorProfilerInfo3::GetModuleInfo2 (Método)	Especificado un identificador de módulo, devuelve el nombre de archivo del módulo, el identificador del ensamblado primario del módulo y una máscara de bits que describe las propiedades del módulo.
ICorProfilerInfo3::GetRuntimeInformation (Método)	Proporciona información de versión sobre el runtime cuyo perfil se está generando.
ICorProfilerInfo3::GetStringLayout2 (Método)	Obtiene información sobre el diseño de un objeto de cadena.
ICorProfilerInfo3::GetThreadStaticAddress2 (Método)	Obtiene la dirección del campo estático de subproceso especificado que se encuentra en el ámbito del subproceso y el dominio de aplicación indicados.
ICorProfilerInfo3::RequestProfilerDetach (Método)	Indica al runtime que desasocie el generador de perfiles.
ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 (Método)	Especifica las funciones implementadas por generador de perfiles a las que se llamarán en las funciones FunctionEnter3, FunctionLeave3 y FunctionTailcall3.
ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo (Método)	Especifica las funciones implementadas por generador de perfiles a las que se llamarán en los enlaces FunctionEnter3WithInfo, FunctionLeave3WithInfo y FunctionTailcall3WithInfo de funciones administradas.
ICorProfilerInfo3::SetFunctionIDMapper2 (Método)	Especifica la función implementada en el generador de perfiles a la que se llamará para asignar valores FunctionID a valores alternativos, que se pasan a los enlaces de entrada y salida de función del generador de perfiles. Este método extiende ICorProfilerInfo::SetFunctionIDMapper con un parámetro que los generadores de perfiles pueden usar para eliminar la ambigüedad entre los runtime.

Comentarios

CLR implementa los métodos de la interfaz ICorProfilerInfo3 usando el modelo de subprocesamiento libre. Cada método devuelve un valor HRESULT para indicar si la ejecución se ha realizado correctamente o si se han producido errores. Para obtener una lista de los posibles códigos devueltos, vea el archivo CorError.h.

CLR pasa una interfaz ICorProfilerInfo3 a cada analizador de código durante la inicialización, mediante la implementación del generador de perfiles del método ICorProfilerCallback::Initialize o ICorProfilerCallback3::InitializeForAttach. A continuación, un generador de perfiles de código puede llamar a los métodos de ICorProfilerInfo3 para obtener información sobre el código administrado que se está ejecutando bajo el control de CLR.

Para obtener información sobre los valores AppDomainID y FunctionID, vea Identificadores para notificaciones en tiempo de ejecución y generación de perfiles.