Compartir a través de

ICorProfilerInfo2 (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 solicitar información. La interfaz ICorProfilerInfo2 es una extensión de la interfaz ICorProfilerInfo. Es decir, proporciona nuevos métodos admitidos en la versión 2.0 de .NET Framework y versiones posteriores.

Métodos

Método Descripción
Método DoStackSnapshot Recorre la pila del subproceso especificado para notificar marcos de llamada administrados al generador de perfiles.
Método EnumModuleFrozenObjects Obtiene un enumerador que permite la iteración sobre los objetos inmovilizados del módulo especificado.
Método GetAppDomainStaticAddress Obtiene la dirección del campo estático del dominio de aplicación que está en el ámbito del dominio de aplicación especificado.
Método GetArrayObjectInfo Obtiene información detallada sobre un objeto de matriz.
Método GetBoxClassLayout Obtiene información sobre el diseño de clase de un tipo de valor especificado al que se ha aplicado una conversión boxing.
Método GetClassFromTokenAndTypeArgs Obtiene el elemento ClassID de un tipo mediante el token de metadatos especificado y los valores ClassID de cualquier argumento de tipo.
Método GetClassIDInfo2 Obtiene el módulo primario de la clase genérica especificada, el token de metadatos de la clase, el elemento ClassID de su clase primaria y el elemento ClassID de cada argumento de tipo, si lo hay, de la clase.
GetClassLayout (Método) Obtiene información sobre la distribución, en memoria, de los campos definidos por la clase especificada. Es decir, este método obtiene los desplazamientos de los campos de la clase.
Método GetCodeInfo2 Obtiene las extensiones del código nativo asociado al FunctionID especificado.
Método GetContextStaticAddress Obtiene la dirección del campo estático de contexto especificado que se encuentra en el ámbito del contexto especificado.
Método GetFunctionFromTokenAndTypeArgs Obtiene el elemento FunctionID de una función mediante el token de metadatos especificado, que contiene la clase, y los valores ClassID de cualquier argumento de tipo.
Método GetFunctionInfo2 Obtiene la clase primaria, el token de metadatos y el ClassID de cada argumento de tipo, si está presente, de una función.
Método GetGenerationBounds Obtiene las regiones de memoria (los segmentos del montón) que componen las generaciones del montón de recolección de elementos no utilizados.
Método GetNotifiedExceptionClauseInfo Obtiene la dirección nativa y la información del marco de la cláusula de excepción (catch/finally/filter) que está a punto de ejecutarse o que se acaba de ejecutar.
Método GetObjectGeneration Obtiene el segmento del montón que contiene el objeto especificado.
Método GetRVAStaticAddress Este método puede usarse para obtener la dirección del campo estático de la dirección virtual relativa (RVA) que se especifique.
Método GetStaticFieldInfo Obtiene el ámbito en el que el campo especificado es estático.
Método GetStringLayout Obtiene información sobre la distribución de un objeto de cadena.
Método GetThreadAppDomain Este método puede usarse para obtener el id. del dominio de aplicación donde el subproceso que se especifique esté ejecutando código.
Método GetThreadStaticAddress Obtiene la dirección del campo estático del subproceso especificado que está en el ámbito del subproceso especificado.
Método SetEnterLeaveFunctionHooks2 Especifica las funciones que implementa el generador de perfiles a las que se llamará en los enlaces "enter", "leave" y "tailcall" de las funciones administradas.

Comentarios

Un generador de perfiles llama a un método en la interfaz ICorProfilerInfo2 para comunicarse con CLR a fin de controlar la supervisión de eventos y la información de la solicitud.

CLR implementa los métodos de la interfaz ICorProfilerInfo2 mediante 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.

CLR pasa una interfaz ICorProfilerInfo2 a cada generador de perfiles del código durante la inicialización, mediante la implementación de ICorProfilerCallback::Initialize del generador de perfiles. Después, un generador de perfiles del código puede llamar a los métodos de la interfaz ICorProfilerInfo2 para obtener información acerca del código administrado que se está ejecutando bajo el control de 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 2.0

Consulte también