ICorProfilerInfo3 (Interfaz)
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
