Compartir a través de

ICorProfilerInfo3 (Interfaz)

  • Artículo

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

Métodos

Método Descripción
Método EnumJITedFunctions Devuelve un enumerador para todas las funciones previamente compiladas con JIT.
Método EnumModules Devuelve un enumerador que proporciona métodos para iterar secuencialmente por una colección de módulos administrados cargados en la aplicación.
Método GetAppDomainsContainingModule Obtiene los identificadores de los dominios de la aplicación en la que se cargó el módulo especificado.
Método GetFunctionEnter3Info Proporciona el marco de pila y la información de los argumentos de la función que se notifica al generador de perfiles mediante la función FunctionEnter3WithInfo; solo se puede llamar durante la devolución de llamada FunctionEnter3WithInfo.
Método GetFunctionLeave3Info Proporciona el marco de pila y el valor devuelto de la función que se notifica al generador de perfiles mediante la función FunctionLeave3WithInfo; solo se puede llamar durante la devolución de llamada FunctionLeave3WithInfo.
Método GetFunctionTailcall3Info Proporciona el marco de pila de la función que se notifica al generador de perfiles mediante la función FunctionTailcall3WithInfo; solo se puede llamar durante la devolución de llamada FunctionTailcall3WithInfo.
Método GetModuleInfo2 Dado 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.
Método GetRuntimeInformation Proporciona información sobre la versión del CLR cuyo perfil se está generando.
Método GetStringLayout2 Obtiene información sobre la distribución de un objeto de cadena.
Método GetThreadStaticAddress2 Obtiene la dirección del campo estático de subproceso especificado que está en el ámbito del subproceso y del dominio de aplicación especificados.
Método RequestProfilerDetach Indica al CLR que desasocie el generador de perfiles.
Método SetEnterLeaveFunctionHooks3 Este método puede usarse para especificar las funciones que haya implementado el generador de perfiles y que se vayan a llamar mediante las funciones FunctionEnter3, FunctionLeave3 y FunctionTailcall3.
Método SetEnterLeaveFunctionHooks3WithInfo Este método puede usarse para especificar las funciones que haya implementado el generador de perfiles y que se vayan a llamar mediante las funciones FunctionEnter3WithInfo, FunctionLeave3WithInfo y FunctionTailcall3WithInfo.
Método SetFunctionIDMapper2 Especifica la función implementada por el generador de perfiles a la que se llamará para asignar los valores FunctionID a valores alternativos, que se pasan 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 entornos de ejecución.

Comentarios

El CLR implementa los métodos de la interfaz ICorProfilerInfo3 usando el modelo de subprocesamiento libre. Cada método devuelve un valor HRESULT para indicar un resultado correcto o erróneo. Para obtener una lista de los posibles códigos devueltos, consulte el archivo CorError.h.

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

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versiones de .NET Framework: disponible a partir de la versión 4

Consulte también