ICorProfilerInfo (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.

Nota

Cada método de la interfaz ICorProfilerInfo devuelve un valor HRESULT para indicar un resultado correcto o erróneo. Consulte CorError.h para obtener una lista de posibles códigos devueltos.

Métodos

método Descripción
Método BeginInprocDebugging Inicializa la compatibilidad con la depuración en proceso. Este método está obsoleto en .NET Framework, versión 2.0.
Método EndInprocDebugging Cierra una sesión de depuración en proceso. Este método está obsoleto en .NET Framework, versión 2.0.
Método ForceGC Obliga a que se produzca la recolección de elementos no utilizados en el entorno de ejecución.
Método GetAppDomainInfo Obtiene información sobre el dominio de aplicación especificado.
Método GetAssemblyInfo Obtiene información acerca del ensamblado especificado.
Método GetClassFromObject Obtiene el ClassID de un objeto

dado su objeto ObjectID.
GetClassFromToken (Método) Obtiene el identificador de la clase , dado el token de metadatos. Este método está obsoleto en .NET Framework, versión 2.0. Use el método ICorProfilerInfo2::GetClassFromTokenAndTypeArgs en su lugar.
Método GetClassIDInfo Este método puede usarse para obtener el módulo primario y el token de metadatos de la clase que se especifique.
Método GetCodeInfo Obtiene la extensión del código nativo asociado al identificador de función especificado. Este método está obsoleto. En su lugar, use el método ICorProfilerInfo2::GetCodeInfo2.
GetCurrentThreadID (Método) Obtiene el identificador del subproceso actual, si este es de tipo administrado.
Método GetEventMask Obtiene las categorías de eventos actuales para las que el generador de perfiles quiere recibir notificaciones de eventos de CLR.
Método GetFunctionFromIP Asigna un puntero de instrucción de código administrado a FunctionID.
GetFunctionFromToken (Método) Obtiene el identificador de una función. Este método está obsoleto en .NET Framework, versión 2.0. En su lugar, use el método ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs.
Método GetFunctionInfo Obtiene la clase primaria y el token de metadatos de la función que se especifique.
Método GetHandleFromThread Asigna el identificador de un subproceso al manipulador de un subproceso de Win32.
Método GetILFunctionBody Obtiene un puntero al cuerpo de un método en código de lenguaje intermedio común (CIL), empezando por su encabezado.
Método GetILFunctionBodyAllocator Obtiene una interfaz que proporciona un método para asignar memoria que se va a usar para intercambiar el cuerpo de un método en el código CIL.
GetILToNativeMapping (Método) Obtiene un mapa de desplazamientos CIL a desplazamientos nativos para el código contenido en la función especificada.
Método GetInprocInspectionInterface Obtiene un objeto que se puede consultar para una interfaz ICorDebugProcess. Este método está obsoleto en .NET Framework, versión 2.0.
Método GetInprocInspectionIThisThread Obtiene un objeto que se puede consultar para la interfaz ICorDebugThread. Este método está obsoleto en .NET Framework, versión 2.0.
Método GetModuleInfo A partir de un identificador de módulo, devuelve el nombre de archivo del módulo y el identificador del ensamblado primario del módulo.
Método GetModuleMetaData Obtiene una instancia de interfaz de metadatos que se asigna al módulo que se especifique.
GetObjectSize (Método) Obtiene el tamaño del objeto que se especifique.
GetThreadContext (Método) Obtiene la identidad de contexto que esté actualmente asociada con el subproceso que se especifique.
Método GetThreadInfo Obtiene la identidad de subproceso de Win32 actual del subproceso que se especifique.
Método GetTokenAndMetadataFromFunction Obtiene el token de metadatos y una instancia de la interfaz de metadatos que se puede usar con el token para la función que se especifique.
Método IsArrayClass Determina si la clase especificada es una clase de matriz.
Método SetEnterLeaveFunctionHooks 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.
Método SetEventMask Establece un valor que especifica los tipos de eventos para los que el generador de perfiles quiere recibir notificaciones desde CLR.
Método SetFunctionIDMapper 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.
Método SetFunctionReJIT No implementado. No debe usarse.
SetILFunctionBody (Método) Reemplaza el cuerpo de la función especificada en el módulo que se especifique.
Método SetILInstrumentedCodeMap Especifica cómo se asignan los desplazamientos de la CIL original de una función especificada a los nuevos desplazamientos de la CIL modificada por el generador de perfiles de la función.

Comentarios

Un generador de perfiles llama a un método en la interfaz ICorProfilerInfo 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 ICorProfilerInfo mediante el modelo de subprocesamiento libre. Cada método devuelve un valor HRESULT para indicar un resultado correcto o erróneo. Consulte CorError.h para obtener una lista de posibles códigos devueltos.

CLR pasa, a través de la implementación del generador de perfiles de ICorProfilerCallback::Initialize, una interfaz ICorProfilerInfo para cada generador de perfiles de código durante la inicialización. Después, un generador de perfiles del código puede llamar a los métodos de la interfaz ICorProfilerInfo 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