Compartir a través de

ICorProfilerCallback (Interfaz)

  • Artículo

Proporciona métodos que Common Language Runtime (CLR) usa para notificar a un generador de perfiles de código cuando se produzcan los eventos a los que se ha suscrito el generador de perfiles.

Métodos

Método Descripción
Método AppDomainCreationFinished Notifica al generador de perfiles que se ha creado un dominio de aplicación.
Método AppDomainCreationStarted Notifica al generador de perfiles que se está creando un dominio de aplicación.
Método AppDomainShutdownFinished Notifica al generador de perfiles que un dominio de aplicación se ha descargado de un proceso.
Método AppDomainShutdownStarted Notifica al generador de perfiles que se está descargando un dominio de aplicación desde un proceso.
Método AssemblyLoadFinished Notifica al generador de perfiles que un ensamblado ha terminado de cargarse.
Método AssemblyLoadStarted Notifica al generador de perfiles que se está cargando un ensamblado.
Método AssemblyUnloadFinished Notifica al generador de perfiles que se ha descargado un ensamblado.
Método AssemblyUnloadStarted Notifica al generador de perfiles que se está descargando un ensamblado.
Método ClassLoadFinished Notifica al generador de perfiles que una clase ha terminado de cargarse.
Método ClassLoadStarted Notifica al generador de perfiles que se está cargando una clase.
Método ClassUnloadFinished Notifica al generador de perfiles que una clase ha terminado de descargarse.
Método ClassUnloadStarted Notifica al generador de perfiles que se está descargando una clase.
Método COMClassicVTableCreated Notifica al generador de perfiles que se ha creado un contenedor RCW para el IID y la clase especificados.
Método COMClassicVTableDestroyed Notifica al generador de perfiles que se está destruyendo un contenedor RCW.
Método ExceptionCatcherEnter Notifica al generador de perfiles de que se va a pasar el control al bloque catch adecuado.
Método ExceptionCatcherLeave Notifica al generador de perfiles de que se va a pasar el control desde el bloque catch adecuado.
Método ExceptionCLRCatcherExecute Elementos obsoletos en .NET Framework, versión 2.0
Método ExceptionCLRCatcherFound Elementos obsoletos en .NET Framework 2.0.
Método ExceptionOSHandlerEnter Sin implementar. Si se necesita información de las excepciones no administradas para un generador de perfiles, esta deberá obtenerse de otra manera.
Método ExceptionOSHandlerLeave Sin implementar. Si se necesita información de las excepciones no administradas para un generador de perfiles, esta deberá obtenerse de otra manera.
Método ExceptionSearchCatcherFound Notifica al generador de perfiles que la fase de búsqueda del control de excepciones ha localizado un controlador para la excepción que se ha producido.
Método ExceptionSearchFilterEnter Notifica al generador de perfiles que se está ejecutando un filtro de usuario.
Método ExceptionSearchFilterLeave Notifica al generador de perfiles que un filtro de usuario acaba de terminar de ejecutarse.
Método ExceptionSearchFunctionEnter Notifica al generador de perfiles que la fase de búsqueda del control de excepciones ha escrito una función.
Método ExceptionSearchFunctionLeave Notifica al generador de perfiles que la fase de búsqueda del mecanismo de control de excepciones ha finalizado un proceso de búsqueda en una función.
Método ExceptionThrown Notifica al generador de perfiles que se ha generado una excepción.
Método ExceptionUnwindFinallyEnter Notifica al generador de perfiles que la fase de desenredo del control de excepciones está escribiendo una cláusula finally contenida en la función especificada.
Método ExceptionUnwindFinallyLeave Notifica al generador de perfiles que la fase de desenredado del control de excepciones ha dejado una cláusula finally.
Método ExceptionUnwindFunctionEnter Notifica al generador de perfiles que la fase de desenredo del control de excepciones ha escrito una función.
Método ExceptionUnwindFunctionLeave Notifica al generador de perfiles que la fase de desenredo del mecanismo de control de excepciones ha finalizado un proceso de desenredo en una función.
Método FunctionUnloadStarted Notifica al generador de perfiles que el entorno de ejecución ha empezado a descargar una función.
Initialize (Método) Se le llama para inicializar el generador de perfiles cada vez que se inicia una nueva aplicación CLR.
Método JITCachedFunctionSearchFinished Notifica al generador de perfiles que una búsqueda ha finalizado para una función que se compiló anteriormente mediante NGen.exe.
Método JITCachedFunctionSearchStarted Notifica al generador de perfiles que se ha iniciado una búsqueda para una función que se compiló anteriormente mediante NGen.exe.
Método JITCompilationFinished Notifica al generador de perfiles que el compilador JIT ha terminado de compilar una función.
Método JITCompilationStarted Notifica al generador de perfiles que el compilador Just-In-Time (JIT) ha empezado a compilar una función.
Método JITFunctionPitched Notifica al generador de perfiles que se ha quitado de la memoria una función que se ha compilado con JIT.
Método JITInlining Notifica al generador de perfiles de que el compilador JIT está a punto de insertar una función en otra.
Método ManagedToUnmanagedTransition Notifica al generador de perfiles que se ha producido una transición del código administrado al código no administrado.
Método ModuleAttachedToAssembly Notifica al generador de perfiles que se está asociando un módulo a su ensamblado primario.
Método ModuleLoadFinished Notifica al generador de perfiles de que un módulo ha terminado de cargarse.
Método ModuleLoadStarted Notifica al generador de perfiles que se está cargando un módulo.
Método ModuleUnloadFinished Notifica al generador de perfiles que un módulo ha terminado de descargarse.
Método ModuleUnloadStarted Notifica al generador de perfiles que se está descargando un módulo.
Método MovedReferences Notifica al generador de perfiles las referencias de objeto que se movieron durante la recolección de elementos no utilizados.
Método ObjectAllocated Notifica al generador de perfiles que se ha asignado memoria en el montón para un objeto.
Método ObjectReferences Notifica al generador de perfiles los objetos en la memoria a los que hace referencia el objeto especificado.
Método ObjectsAllocatedByClass Notifica al generador de perfiles el número de instancias de cada clase especificada que se ha creado desde la última recolección de elementos no utilizados.
Método RemotingClientInvocationFinished Notifica al generador de perfiles de que una llamada de comunicación remota se ha ejecutado y se ha finalizado en el cliente.
Método RemotingClientInvocationStarted Notifica al generador de perfiles de que se ha iniciado una llamada de comunicación remota.
Método RemotingClientReceivingReply Notifica al generador de perfiles que se ha completado la parte del lado servidor de una llamada de comunicación remota, y que el cliente está recibiendo la respuesta y está a punto de procesarla.
Método RemotingClientSendingMessage Notifica al generador de perfiles que el cliente envía una solicitud al servidor.
Método RemotingServerInvocationReturned Notifica al generador de perfiles que el proceso ha terminado de invocar un método en respuesta a una solicitud de invocación de método remoto.
Método RemotingServerInvocationStarted Notifica al generador de perfiles de que el proceso va a invocar un método en respuesta a una solicitud de invocación de método remoto.
Método RemotingServerReceivingMessage Notifica al generador de perfiles que el proceso va a recibir una solicitud de activación o invocación de método remoto.
Método RemotingServerSendingReply Notifica al generador de perfiles que el proceso ha terminado de procesar una solicitud de invocación de método remoto y está a punto de transmitir la respuesta mediante un canal.
Método RootReferences Notifica al generador de perfiles información sobre las referencias raíz después de la recolección de elementos no utilizados.
Método RuntimeResumeFinished Notifica al generador de perfiles que se han reanudado todos los subprocesos del tiempo de ejecución y que este está funcionando normalmente de nuevo.
Método RuntimeResumeStarted Notifica al generador de perfiles que el entorno de ejecución va a reanudar todos los subprocesos en tiempo de ejecución.
Método RuntimeSuspendAborted Notifica al generador de perfiles que el entorno de ejecución ha anulado la suspensión en tiempo de ejecución que se estaba produciendo.
Método RuntimeSuspendFinished Notifica al generador de perfiles que el entorno de ejecución ha completado la suspensión de todos los subprocesos en tiempo de ejecución.
Método RuntimeSuspendStarted Notifica al generador de perfiles que el entorno de ejecución está a punto de suspender todos los subprocesos en tiempo de ejecución.
Método RuntimeThreadResumed Notifica al generador de perfiles que el subproceso especificado se ha reanudado después de suspenderse.
Método RuntimeThreadSuspended Notifica al generador de perfiles que el subproceso especificado se ha suspendido o está a punto de suspenderse.
Método Shutdown Notifica al generador de perfiles que se está apagando la aplicación.
Método ThreadAssignedToOSThread Notifica al generador de perfiles que se está implementando un subproceso administrado mediante un subproceso de sistema operativo (SO) determinado.
Método ThreadCreated Notifica al generador de perfiles que se ha creado un subproceso.
Método ThreadDestroyed Notifica al generador de perfiles que se ha destruido un subproceso.
Método UnmanagedToManagedTransition Notifica al generador de perfiles que se ha producido una transición de código no administrado a código administrado.

Comentarios

CLR llama a un método de la interfaz ICorProfilerCallback (o ICorProfilerCallback2) para notificar al generador de perfiles cuando se produce un evento al que se ha suscrito. Esta es la interfaz de devolución de llamada principal a través de la cual CLR se comunica con el generador de perfiles de código.

Un generador de perfiles de código debe implementar los métodos de la interfaz ICorProfilerCallback. Para .NET Framework, versión 2.0 o posterior, el generador de perfiles también debe implementar los métodos ICorProfilerCallback2. Cada implementación de método debe devolver un HRESULT que tenga un valor de S_OK en caso de que se complete correctamente o E_FAIL en caso de error. Actualmente, CLR omite el HRESULT devuelto por cada devolución de llamada excepto ICorProfilerCallback::ObjectReferences.

En el Registro de Microsoft Windows, un generador de perfiles de código debe registrar su objeto Modelo de objetos componentes (COM) que implemente las interfaces ICorProfilerCallback y ICorProfilerCallback2. Un generador de perfiles de código se suscribe a los eventos para los que desea recibir notificaciones mediante una llamada a ICorProfilerInfo::SetEventMask. Esto suele hacerse en la implementación del generador de perfiles de ICorProfilerCallback::Initialize. Después, el generador de perfiles puede recibir notificaciones del entorno de ejecución cuando un evento está a punto de producirse o se acaba de producir en un proceso en ejecución.

Nota

El generador de perfiles registra un único objeto COM. Si el generador de perfiles tiene como destino la versión 1.0 o 1.1 de .NET Framework, ese objeto COM solo debe implementar los métodos de ICorProfilerCallback. Si tiene como destino .NET Framework, versión 2.0 o posterior, el objeto COM también debe implementar los métodos de ICorProfilerCallback2.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versiones de .NET Framework: está disponible desde la versión 1.0

Consulte también