ICorProfilerCallback, interface

Fournit des méthodes qui sont utilisées par le Common Language Runtime (CLR) pour avertir un profileur de code lorsque les événements auxquels il est abonné ont lieu.

Méthodes

Méthode	Description
ICorProfilerCallback::AppDomainCreationFinished, méthode	Informe le profileur qu'un domaine d'application a été créé.
ICorProfilerCallback::AppDomainCreationStarted, méthode	Informe le profileur qu'un domaine d'application est créé.
ICorProfilerCallback::AppDomainShutdownFinished, méthode	Informe le profileur qu'un domaine d'application a été déchargé d'un processus.
ICorProfilerCallback::AppDomainShutdownStarted, méthode	Informe le profileur qu'un domaine d'application est déchargé d'un processus.
ICorProfilerCallback::AssemblyLoadFinished, méthode	Informe le profileur qu'un assembly a été chargé.
ICorProfilerCallback::AssemblyLoadStarted, méthode	Informe le profileur qu'un assembly est chargé.
ICorProfilerCallback::AssemblyUnloadFinished, méthode	Informe le profileur qu'un assembly a été déchargé.
ICorProfilerCallback::AssemblyUnloadStarted, méthode	Informe le profileur qu'un assembly est déchargé.
ICorProfilerCallback::ClassLoadFinished, méthode	Informe le profileur qu'une classe a été chargée.
ICorProfilerCallback::ClassLoadStarted, méthode	Informe le profileur qu'une classe est chargée.
ICorProfilerCallback::ClassUnloadFinished, méthode	Informe le profileur qu'une classe a été déchargée.
ICorProfilerCallback::ClassUnloadStarted, méthode	Informe le profileur qu'une classe est déchargée.
ICorProfilerCallback::COMClassicVTableCreated, méthode	Informe le profileur qu'un wrapper RCW (Runtime Callable Wrapper) pour l'IID et la classe spécifiés a été créé.
ICorProfilerCallback::COMClassicVTableDestroyed, méthode	Informe le profileur qu'un wrapper RCW est détruit.
ICorProfilerCallback::ExceptionCatcherEnter, méthode	Informe le profileur que le contrôle est passé au bloc catch approprié.
ICorProfilerCallback::ExceptionCatcherLeave, méthode	Informe le profileur que le contrôle est passé hors du bloc catch approprié.
ICorProfilerCallback::ExceptionCLRCatcherExecute, méthode	Obsolète dans la version 2.0 du .NET Framework.
ICorProfilerCallback::ExceptionCLRCatcherFound, méthode	Obsolète dans le .NET Framework 2.0.
ICorProfilerCallback::ExceptionOSHandlerEnter, méthode	Pas implémenté. Un profileur qui a besoin des informations d'exceptions non managées doit les obtenir par un autre moyen.
ICorProfilerCallback::ExceptionOSHandlerLeave, méthode	Pas implémenté. Un profileur qui a besoin des informations d'exceptions non managées doit les obtenir par un autre moyen.
ICorProfilerCallback::ExceptionSearchCatcherFound, méthode	Informe le profileur que la phase de recherche de la gestion des exceptions a trouvé un gestionnaire pour l'exception qui a été levée.
ICorProfilerCallback::ExceptionSearchFilterEnter, méthode	Informe le profileur qu'un filtre utilisateur est exécuté.
ICorProfilerCallback::ExceptionSearchFilterLeave, méthode	Informe le profileur que l'exécution d'un filtre utilisateur vient de se terminer.
ICorProfilerCallback::ExceptionSearchFunctionEnter, méthode	Avertit le profileur que la phase de recherche de la gestion d'exceptions est entrée dans une fonction.
ICorProfilerCallback::ExceptionSearchFunctionLeave, méthode	Avertit le profileur que la phase de recherche de la gestion d'exceptions a terminé la recherche d'une fonction.
ICorProfilerCallback::ExceptionThrown, méthode	Informe le profileur qu'une exception a été levée.
ICorProfilerCallback::ExceptionUnwindFinallyEnter, méthode	Informe le profileur que la phase de déroulement de la gestion d'exceptions entre dans une clause finally contenue dans la fonction spécifiée.
ICorProfilerCallback::ExceptionUnwindFinallyLeave, méthode	Informe le profileur que la phase de déroulement de la gestion des exceptions a quitté une clause finally.
ICorProfilerCallback::ExceptionUnwindFunctionEnter, méthode	Avertit le profileur que la phase de déroulement de la gestion d'exceptions est entrée dans une fonction.
ICorProfilerCallback::ExceptionUnwindFunctionLeave, méthode	Notifie au profileur que la phase de déroulement de la gestion des exceptions a terminé le déroulement d'une fonction.
ICorProfilerCallback::FunctionUnloadStarted, méthode	Informe le profileur que le runtime a commencé à décharger une fonction.
ICorProfilerCallback::Initialize, méthode	Appelé pour initialiser le profileur chaque fois qu'une nouvelle application CLR est démarrée.
ICorProfilerCallback::JITCachedFunctionSearchFinished, méthode	Informe le profileur qu'une recherche s'est terminée pour une fonction précédemment compilée à l'aide de NGen.exe.
ICorProfilerCallback::JITCachedFunctionSearchStarted, méthode	Informe le profileur qu'une recherche a démarré pour une fonction précédemment compilée à l'aide de NGen.exe.
ICorProfilerCallback::JITCompilationFinished, méthode	Informe le profileur que le compilateur JIT a fini de compiler une fonction.
ICorProfilerCallback::JITCompilationStarted, méthode	Informe le profileur que le compilateur juste-à-temps (JIT, Just-In-Time) a commencé à compiler une fonction.
ICorProfilerCallback::JITFunctionPitched, méthode	Informe le profileur qu'une fonction compilée juste-à-temps (JIT, Just-In-Time) a été supprimée de la mémoire.
ICorProfilerCallback::JITInlining, méthode	Informe le profileur que le compilateur JIT va insérer une fonction alignée sur une autre fonction.
ICorProfilerCallback::ManagedToUnmanagedTransition, méthode	Informe le profileur qu'une transition s'est produite de code managé à code non managé.
ICorProfilerCallback::ModuleAttachedToAssembly, méthode	Informe le profileur qu'un module est attaché à son assembly parent.
ICorProfilerCallback::ModuleLoadFinished, méthode	Informe le profileur qu'un module a été chargé.
ICorProfilerCallback::ModuleLoadStarted, méthode	Informe le profileur qu'un module est chargé.
ICorProfilerCallback::ModuleUnloadFinished, méthode	Informe le profileur qu'un module a été déchargé.
ICorProfilerCallback::ModuleUnloadStarted, méthode	Informe le profileur qu'un module est déchargé.
ICorProfilerCallback::MovedReferences, méthode	Informe le profileur sur les références d'objet qui ont été déplacées pendant le garbage collection.
ICorProfilerCallback::ObjectAllocated, méthode	Informe le profileur que la mémoire dans le tas a été allouée à un objet.
ICorProfilerCallback::ObjectReferences, méthode	Informe le profileur sur les objets en mémoire référencés par l'objet spécifié.
ICorProfilerCallback::ObjectsAllocatedByClass, méthode	Informe le profileur sur le nombre d'instances de chaque classe spécifiée qui ont été créées depuis le dernier garbage collection.
ICorProfilerCallback::RemotingClientInvocationFinished, méthode	Informe le profileur de code qu'un appel de communication à distance a abouti sur le client.
ICorProfilerCallback::RemotingClientInvocationStarted, méthode	Informe le profileur qu'un appel de communication à distance a débuté.
ICorProfilerCallback::RemotingClientReceivingReply, méthode	Avertit le profileur que la partie côté serveur d'un appel de communication à distance est terminée et que le client est maintenant en phase de réception et s'apprête à traiter la réponse.
ICorProfilerCallback::RemotingClientSendingMessage, méthode	Informe le profileur que le client envoie une demande au serveur.
ICorProfilerCallback::RemotingServerInvocationReturned, méthode	Informe le profileur que le processus a fini d'appeler une méthode à la suite d'une demande d'appel de méthode distante.
ICorProfilerCallback::RemotingServerInvocationStarted, méthode	Informe le profileur que le processus appelle une méthode à la suite d'une demande d'appel de méthode distante.
ICorProfilerCallback::RemotingServerReceivingMessage, méthode	Informe le profileur que le processus reçoit une demande d'activation ou un appel de méthode distant.
ICorProfilerCallback::RemotingServerSendingReply, méthode	Informe le profileur que le processus a fini de traiter une demande d'appel de méthode distante et va transmettre la réponse via un canal.
ICorProfilerCallback::RootReferences, méthode	Fournit au profileur des informations sur les références racine après le garbage collection.
ICorProfilerCallback::RuntimeResumeFinished, méthode	Informe le profileur que le runtime a repris tous ses threads et est retourné à un fonctionnement normal.
ICorProfilerCallback::RuntimeResumeStarted, méthode	Informe le profileur que le runtime reprend tous les threads du runtime.
ICorProfilerCallback::RuntimeSuspendAborted, méthode	Informe le profileur que le runtime a abandonné l'arrêt en cours du runtime.
ICorProfilerCallback::RuntimeSuspendFinished, méthode	Informe le profileur que le runtime a fini de suspendre tous les threads du runtime.
ICorProfilerCallback::RuntimeSuspendStarted, méthode	Informe le profileur que le runtime va suspendre tous les threads du runtime.
ICorProfilerCallback::RuntimeThreadResumed, méthode	Informe le profileur que l'exécution du thread spécifié a repris après avoir été suspendue.
ICorProfilerCallback::RuntimeThreadSuspended, méthode	Informe le profileur que le thread spécifié a été ou va être suspendu.
ICorProfilerCallback::Shutdown, méthode	Informe le profileur de l'arrêt de l'application.
ICorProfilerCallback::ThreadAssignedToOSThread, méthode	Informe le profileur qu'un thread managé est en cours d'implémentation à l'aide d'un thread de système d'exploitation spécifique.
ICorProfilerCallback::ThreadCreated, méthode	Informe le profileur qu'un thread a été créé.
ICorProfilerCallback::ThreadDestroyed, méthode	Informe le profileur qu'un thread a été détruit.
ICorProfilerCallback::UnmanagedToManagedTransition, méthode	Informe le profileur qu'une transition s'est produite de code non managé à code managé.

Notes

Le CLR appelle une méthode dans l'interface ICorProfilerCallback (ou ICorProfilerCallback2) pour informer le profileur lorsqu'un événement auquel il s'est abonné se produit. Il s'agit de l'interface de rappel principale par le biais de laquelle le Common Language Runtime communique avec le profileur de code.

Un profileur de code doit implémenter les méthodes de l'interface ICorProfilerCallback. Pour .NET Framework 2.0 ou version ultérieure, le profileur doit également implémenter les méthodes ICorProfilerCallback2. Chaque implémentation de méthode doit retourner un HRESULT avec la valeur S_OK en cas de réussite ou la valeur E_FAIL en cas d'échec. Actuellement, le CLR ignore le HRESULT retourné à chaque rappel à l'exception de ICorProfilerCallback::ObjectReferences.

Dans le Registre Microsoft Windows, un profileur de code doit enregistrer son objet COM qui implémente les interfaces ICorProfilerCallback et ICorProfilerCallback2. Un profileur de code s'abonne aux événements pour lesquels il souhaite recevoir une notification en appelant ICorProfilerInfo::SetEventMask. Cette opération est généralement exécutée dans l'implémentation du profileur de ICorProfilerCallback::Initialize. Le profileur peut ensuite recevoir une notification du runtime lorsqu'un événement est sur le point de se produire ou vient de se produire dans un processus de runtime en cours d'exécution.

Remarque
Le profileur enregistre un seul objet COM.Si le profileur cible .NET Framework version 1.0 ou 1.1, cet objet COM doit implémenter uniquement les méthodes de ICorProfilerCallback.S'il cible .NET Framework 2.0 ou version ultérieure, l'objet COM doit également implémenter les méthodes de ICorProfilerCallback2.

Spécifications

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : CorProf.idl, CorProf.h

Bibliothèque : CorGuids.lib

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Voir aussi

Référence

ICorProfilerCallback2, interface

Autres ressources

Interfaces de profilage