ICorProfilerCallback2, 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. L'interface ICorProfilerCallback2 est une extension de l'interface ICorProfilerCallback. En d'autres termes, elle fournit de nouveaux rappels ajoutés à .NET Framework version 2.0.
.gif "Remarque") Remarque |
|---|
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. |
Méthodes
Méthode |
Description |
|---|---|
Avertit le profileur de code qu'un objet avec un finaliseur a été mis en file d'attente dans le thread finaliseur pour l'exécution de sa méthode Finalize. |
|
Informe le profileur qu'un garbage collection est terminé et que tous les rappels de garbage collection correspondants ont été publiés. |
|
Informe le profileur de code qu'un garbage collection a démarré. |
|
Informe le profileur de code qu'un handle de garbage collection a été créé. |
|
Informe le profileur de code qu'un handle de garbage collection a été détruit. |
|
Informe le profileur concernant les références racine après un garbage collection. Cette méthode est une extension de la méthode ICorProfilerCallback::RootReferences. |
|
Informe le profileur concernant les références d'objet qui ont survécu à un garbage collection. |
|
Informe le profileur de code que le nom d'un thread a changé. |
Notes
Le CLR appelle une méthode dans l'interface ICorProfilerCallback (ou ICorProfilerCallback2) pour informer le profileur lorsqu'un événement auquel il s'était 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 et versions ultérieures, 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.
Un profileur de code doit enregistrer dans le Registre Microsoft Windows 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 la version 1.0 ou 1.1 du .NET Framework, l'objet COM doit uniquement implémenter les méthodes de ICorProfilerCallback.S'il cible .NET Framework 2.0 et versions ultérieures, 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
Voir aussi
Référence
ICorProfilerCallback, interface