Delen via

ICorProfilerCallback-interface

  • Artikel

Biedt methoden die worden gebruikt door de Common Language Runtime (CLR) om een code profiler te waarschuwen wanneer de gebeurtenissen waarop de profiler is geabonneerd zich voordoen.

Methoden

Methode Beschrijving
Methode AppDomainCreationFinished Hiermee wordt aan de profiler gemeld dat er een toepassingsdomein is gemaakt.
Methode AppDomainCreationStarted De profiler meldt dat er een toepassingsdomein wordt gemaakt.
Methode AppDomainShutdownFinished Hiermee wordt de profiler gewaarschuwd dat een toepassingsdomein uit een proces is verwijderd.
Methode AppDomainShutdownStarted Hiermee wordt aan de profiler gemeld dat een toepassingsdomein uit een proces wordt verwijderd.
Methode AssemblyLoadFinished De profiler meldt dat een assembly klaar is met laden.
Methode AssemblyLoadStarted Hiermee wordt aan de profiler gemeld dat een assembly wordt geladen.
Methode AssemblyUnloadFinished Hiermee wordt aan de profiler gemeld dat een assembly is verwijderd.
Methode AssemblyUnloadStarted De profiler meldt dat een assembly wordt verwijderd.
Methode ClassLoadFinished Hiermee wordt aan de profiler gemeld dat een klasse klaar is met laden.
Methode ClassLoadStarted Geeft de profiler een bericht dat een klasse wordt geladen.
Methode ClassUnloadFinished De profiler meldt dat een klasse klaar is met lossen.
Methode ClassUnloadStarted Hiermee wordt de profiler gewaarschuwd dat een klasse wordt verwijderd.
Methode COMClassicVTableCreated Hiermee wordt aan de profiler gemeld dat een runtime-aanroepbare wrapper (RCW) voor de opgegeven IID en klasse is gemaakt.
Methode COMClassicVTableDestroyed De profiler meldt dat een RCW wordt vernietigd.
Methode ExceptionCatcherEnter Hiermee wordt de profiler gewaarschuwd dat het besturingselement wordt doorgegeven aan het juiste catch blok.
Methode ExceptionCatcherLeave Hiermee wordt aan de profiler gemeld dat het besturingselement wordt doorgegeven aan het juiste catch blok.
Methode ExceptionCLRCatcherExecute Verouderd in .NET Framework versie 2.0.
Methode ExceptionCLRCatcherFound Verouderd in de .NET Framework 2.0.
Methode ExceptionOSHandlerEnter Niet geïmplementeerd. Een profiler die onbeheerde uitzonderingsinformatie nodig heeft, moet deze informatie op een andere wijze verkrijgen.
Methode ExceptionOSHandlerLeave Niet geïmplementeerd. Een profiler die onbeheerde uitzonderingsinformatie nodig heeft, moet deze informatie op een andere wijze verkrijgen.
Methode ExceptionSearchCatcherFound Hiermee wordt aan de profiler gemeld dat de zoekfase van de uitzonderingsafhandeling een handler heeft gevonden voor de uitzondering die is gegenereerd.
Methode ExceptionSearchFilterEnter Hiermee wordt aan de profiler gemeld dat een gebruikersfilter wordt uitgevoerd.
Methode ExceptionSearchFilterLeave Hiermee wordt aan de profiler gemeld dat een gebruikersfilter zojuist is uitgevoerd.
Methode ExceptionSearchFunctionEnter Hiermee wordt aan de profiler gemeld dat de zoekfase van de uitzonderingsafhandeling een functie heeft ingevoerd.
Methode ExceptionSearchFunctionLeave Hiermee wordt aan de profiler gemeld dat de zoekfase van de uitzonderingsafhandeling het doorzoeken van een functie heeft voltooid.
Methode ExceptionThrown Hiermee wordt de profiler gewaarschuwd dat er een uitzondering is opgetreden.
Methode ExceptionUnwindFinallyEnter Hiermee wordt aan de profiler gemeld dat de fase voor het afbouwen van de uitzonderingsafhandeling een finally component in de opgegeven functie invoert.
Methode ExceptionUnwindFinallyLeave Hiermee wordt aan de profiler gemeld dat de fase voor het afbouwen van de uitzonderingsafhandeling een finally component heeft achtergelaten.
Methode ExceptionUnwindFunctionEnter Hiermee wordt aan de profiler gemeld dat de fase voor het afbouwen van de uitzonderingsafhandeling een functie heeft ingevoerd.
Methode ExceptionUnwindFunctionLeave Hiermee wordt aan de profiler gemeld dat de afwikkelfase van de uitzonderingsafhandeling een functie heeft voltooid.
Methode FunctionUnloadStarted Hiermee wordt aan de profiler gemeld dat de runtime is gestart om een functie te verwijderen.
Methode initialiseren Aangeroepen om de profiler te initialiseren wanneer een nieuwe CLR-toepassing wordt gestart.
Methode JITCachedFunctionSearchFinished Hiermee wordt aan de profiler gemeld dat een zoekopdracht is voltooid voor een functie die eerder is gecompileerd met behulp van NGen.exe.
Methode JITCachedFunctionSearchStarted Hiermee wordt aan de profiler gemeld dat een zoekopdracht is gestart naar een functie die eerder is gecompileerd met behulp van NGen.exe.
Methode JITCompilationFinished Hiermee wordt aan de profiler gemeld dat de JIT-compiler klaar is met het compileren van een functie.
Methode JITCompilationStarted Hiermee wordt aan de profiler gemeld dat de JIT-compiler (Just-In-Time) is gestart met het compileren van een functie.
Methode JITFunctionPitched Hiermee wordt de profiler gewaarschuwd dat een functie die met JIT is gecompileerd, uit het geheugen is verwijderd.
Methode JITInlining De profiler meldt dat de JIT-compiler op het punt staat een functie in te voegen die overeenkomt met een andere functie.
Methode ManagedToUnmanagedTransition Hiermee wordt aan de profiler gemeld dat er een overgang is opgetreden van beheerde code naar niet-beheerde code.
Methode ModuleAttachedToAssembly De profiler meldt dat een module wordt gekoppeld aan de bovenliggende assembly.
Methode ModuleLoadFinished Hiermee wordt aan de profiler gemeld dat een module is geladen.
Methode ModuleLoadStarted Hiermee wordt aan de profiler gemeld dat een module wordt geladen.
Methode ModuleUnloadFinished De profiler meldt dat een module klaar is met lossen.
Methode ModuleUnloadStarted De profiler meldt dat een module wordt verwijderd.
Methode MovedReferences Hiermee wordt de profiler op de hoogte gebracht van objectverwijzingen die zijn verplaatst tijdens de garbagecollection.
Methode ObjectAllocated Hiermee wordt aan de profiler gemeld dat geheugen binnen de heap is toegewezen voor een -object.
Methode ObjectReferences Hiermee wordt de profiler op de hoogte gesteld van objecten in het geheugen waarnaar wordt verwezen door het opgegeven object.
Methode ObjectsAllocatedByClass Hiermee wordt de profiler op de hoogte gebracht van het aantal exemplaren van elke opgegeven klasse dat is gemaakt sinds de vorige garbagecollection.
Methode RemotingClientInvocationFinished Hiermee wordt aan de profiler gemeld dat een externe aanroep is uitgevoerd totdat deze is voltooid op de client.
Methode RemotingClientInvocationStarted Hiermee wordt aan de profiler gemeld dat een externe aanroep is gestart.
Methode RemotingClientReceivingReply Hiermee wordt aan de profiler gemeld dat het gedeelte aan de serverzijde van een externe aanroep is voltooid en dat de client het antwoord nu ontvangt en gaat verwerken.
Methode RemotingClientSendingMessage Hiermee wordt aan de profiler gemeld dat de client een aanvraag naar de server verzendt.
Methode RemotingServerInvocationReturned Hiermee wordt aan de profiler gemeld dat het proces is voltooid met het aanroepen van een methode als reactie op een aanvraag voor het aanroepen van een externe methode.
Methode RemotingServerInvocationStarted Hiermee wordt de profiler gewaarschuwd dat het proces een methode aanroept als reactie op een aanvraag voor het aanroepen van een externe methode.
Methode RemotingServerReceivingMessage Hiermee wordt de profiler gewaarschuwd dat het proces een externe methode-aanroep of activeringsaanvraag ontvangt.
Methode RemotingServerSendingReply De profiler meldt dat het proces de verwerking van een aanvraag voor het aanroepen van de externe methode heeft voltooid en dat het antwoord via een kanaal wordt verzonden.
Methode RootReferences Hiermee wordt de profiler gewaarschuwd met informatie over hoofdverwijzingen na garbagecollection.
Methode RuntimeResumeFinished Hiermee wordt aan de profiler gemeld dat de runtime alle runtime-threads heeft hervat en de normale werking is hersteld.
Methode RuntimeResumeStarted Hiermee wordt aan de profiler gemeld dat de runtime alle runtime-threads hervat.
Methode RuntimeSuspendAborted Hiermee wordt aan de profiler gemeld dat de runtime de onderbreking van de runtime heeft afgebroken.
Methode RuntimeSuspendFinished Hiermee wordt aan de profiler gemeld dat de runtime de opschorting van alle runtime-threads heeft voltooid.
Methode RuntimeSuspendStarted Hiermee wordt de profiler gewaarschuwd dat de runtime op het punt staat alle runtime-threads te onderbreken.
Methode RuntimeThreadResumed Hiermee wordt aan de profiler gemeld dat de opgegeven thread is hervat nadat deze is onderbroken.
Methode RuntimeThreadSuspended Hiermee wordt aan de profiler gemeld dat de opgegeven thread is of binnenkort wordt onderbroken.
Afsluitmethode Geeft de profiler een bericht dat de toepassing wordt afgesloten.
Methode ThreadAssignedToOSThread Waarschuwt de profiler dat een beheerde thread wordt geïmplementeerd met behulp van een bepaalde besturingssysteemthread (OS).
Methode ThreadCreated Geeft de profiler een bericht dat er een thread is gemaakt.
Methode ThreadDestroyed Geeft de profiler een bericht dat een thread is vernietigd.
Methode UnmanagedToManagedTransition Hiermee wordt de profiler gewaarschuwd dat er een overgang van niet-beheerde code naar beheerde code is opgetreden.

Opmerkingen

De CLR roept een methode aan in de ICorProfilerCallback interface (of ICorProfilerCallback2) om de profiler te waarschuwen wanneer een gebeurtenis plaatsvindt waarop de profiler zich heeft geabonneerd. Dit is de primaire callback-interface waarmee de CLR communiceert met de code profiler.

Een codeprofiel moet de methoden van de ICorProfilerCallback interface implementeren. Voor de .NET Framework versie 2.0 of hoger moet de profiler ook de ICorProfilerCallback2 methoden implementeren. Elke implementatie van een methode moet een HRESULT retourneren met de waarde S_OK op succes of E_FAIL op fouten. Momenteel negeert de CLR de HRESULT die door elke callback wordt geretourneerd, met uitzondering van ICorProfilerCallback::ObjectReferences.

In het Microsoft Windows-register moet een codeprofielprogramma het COM-object (Component Object Model) registreren waarmee de ICorProfilerCallback interfaces en ICorProfilerCallback2 worden geïmplementeerd. Een code profiler abonneert zich op de gebeurtenissen waarvoor deze een melding wil ontvangen door ICorProfilerInfo::SetEventMask aan te roepen. Dit wordt meestal gedaan in de implementatie van ICorProfilerCallback::Initialize door de profiler. De profiler kan vervolgens een melding ontvangen van de runtime wanneer een gebeurtenis op het punt staat te plaatsvinden of zojuist is opgetreden in een uitvoerend runtimeproces.

Notitie

De profiler registreert één COM-object. Als de profiler is gericht op de .NET Framework versie 1.0 of 1.1, hoeft dat COM-object alleen de methoden van ICorProfilerCallbackte implementeren. Als het is gericht op .NET Framework versie 2.0 of hoger, moet het COM-object ook de methoden van ICorProfilerCallback2implementeren.

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorProf.idl, CorProf.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 1.0

Zie ook