Dela via

ICorProfilerCallback-gränssnitt

  • Artikel

Innehåller metoder som används av CLR (Common Language Runtime) för att meddela en kodprofilerare när de händelser som profileraren prenumererar på inträffar.

Metoder

Metod Beskrivning
AppDomainCreationFinished-metod Meddelar profileraren att en programdomän har skapats.
AppDomainCreationStarted-metod Meddelar profileraren att en programdomän skapas.
AppDomainShutdownFinished-metod Meddelar profileraren att en programdomän har tagits bort från en process.
AppDomainShutdownStarted-metod Meddelar profileraren att en programdomän tas bort från en process.
AssemblyLoadFinished-metod Meddelar profileraren att en sammansättning har lästs in.
AssemblyLoadStarted-metod Meddelar profileraren att en sammansättning läses in.
AssemblyUnloadFinished-metod Meddelar profileraren att en sammansättning har lossats.
AssemblyUnloadStarted-metod Meddelar profileraren att en sammansättning håller på att tas bort.
ClassLoadFinished-metod Meddelar profileraren att en klass har lästs in.
ClassLoadStarted-metod Meddelar profileraren att en klass läses in.
ClassUnloadFinished-metod Meddelar profileraren att en klass har avslutat avlastningen.
ClassUnloadStarted-metod Meddelar profileraren att en klass håller på att tas bort.
COMClassicVTableCreated-metod Meddelar profileraren att en anropsbar omslutning (RCW) för angivet IID och klass har skapats.
COMClassicVTableDestroyed-metod Meddelar profileraren att en RCW håller på att förstöras.
ExceptionCatcherEnter-metod Meddelar profileraren att kontrollen skickas till lämpligt catch block.
ExceptionCatcherLeave-metod Meddelar profileraren att kontrollen skickas ut från rätt catch block.
ExceptionCLRCatcherExecute-metod Föråldrad i .NET Framework version 2.0.
ExceptionCLRCatcherFound-metod Föråldrad i .NET Framework 2.0.
ExceptionOSHandlerEnter-metod Inte implementerat. En profilerare som behöver ohanterad undantagsinformation måste hämta den här informationen på annat sätt.
ExceptionOSHandlerLeave-metod Inte implementerat. En profilerare som behöver ohanterad undantagsinformation måste hämta den här informationen på annat sätt.
ExceptionSearchCatcherFound-metod Meddelar profileraren att sökfasen för undantagshantering har hittat en hanterare för undantaget som utlöstes.
ExceptionSearchFilterEnter-metod Meddelar profileraren att ett användarfilter körs.
ExceptionSearchFilterLeave-metod Meddelar profileraren att ett användarfilter just har slutfört körningen.
ExceptionSearchFunctionEnter-metod Meddelar profileraren att sökfasen för undantagshantering har angett en funktion.
ExceptionSearchFunctionLeave-metod Meddelar profileraren att sökfasen för undantagshanteringen har slutfört sökningen i en funktion.
ExceptionThrown-metod Meddelar profileraren att ett undantag har genererats.
ExceptionUnwindFinallyEnter-metod Meddelar profileraren att avspolningsfasen för undantagshantering anger en finally -sats som finns i den angivna funktionen.
ExceptionUnwindFinallyLeave-metod Meddelar profileraren att avspolningsfasen för undantagshantering har lämnat en finally -sats.
ExceptionUnwindFunctionEnter-metod Meddelar profileraren att avspolningsfasen för undantagshantering har angett en funktion.
ExceptionUnwindFunctionLeave-metod Meddelar profileraren att avspolningsfasen för undantagshantering har slutfört avspolningen av en funktion.
FunctionUnloadStarted-metod Meddelar profileraren att körningen har börjat ta bort en funktion.
Initiera metod Anropas för att initiera profileraren när ett nytt CLR-program startas.
JITCachedFunctionSearchFinished-metod Meddelar profileraren att en sökning har slutförts för en funktion som kompilerats tidigare med hjälp av NGen.exe.
JITCachedFunctionSearchStarted-metod Meddelar profileraren att en sökning har startats för en funktion som kompilerats tidigare med hjälp av NGen.exe.
JITCompilationFinished-metod Meddelar profileraren att JIT-kompilatorn har slutfört kompileringen av en funktion.
JITCompilationStarted-metod Meddelar profileraren att JIT-kompilatorn (just-in-time) har börjat kompilera en funktion.
JITFunctionPitched-metod Meddelar profileraren att en funktion som har JIT-kompilerats har tagits bort från minnet.
JITInlining-metod Meddelar profileraren att JIT-kompilatorn håller på att infoga en funktion i linje med en annan funktion.
ManagedToUnmanagedTransition-metod Meddelar profileraren att en övergång från hanterad kod till ohanterad kod har skett.
ModuleAttachedToAssembly-metod Meddelar profileraren att en modul kopplas till den överordnade sammansättningen.
ModuleLoadFinished-metod Meddelar profileraren att en modul har lästs in.
ModuleLoadStarted-metod Meddelar profileraren att en modul läses in.
ModuleUnloadFinished-metod Meddelar profileraren att en modul har avslutat avlastningen.
ModuleUnloadStarted-metod Meddelar profileraren att en modul håller på att tas bort.
MovedReferences-metod Meddelar profileraren om objektreferenser som flyttades under skräpinsamlingen.
ObjectAllocated-metod Meddelar profileraren att minnet i heapen har allokerats för ett objekt.
ObjectReferences-metod Meddelar profileraren om objekt i minnet som refereras av det angivna objektet.
ObjectsAllocatedByClass-metod Meddelar profileraren om antalet instanser av varje angiven klass som har skapats sedan den tidigare skräpinsamlingen.
RemotingClientInvocationFinished-metod Meddelar profileraren att ett fjärrkommunikationsanrop har körts för att slutföras på klienten.
RemotingClientInvocationStarted-metod Meddelar profileraren att ett fjärrkommunikationsanrop har startat.
RemotingClientReceivingReply-metod Meddelar profileraren att serverdelen av ett fjärrkommunikationsanrop har slutförts och att klienten nu tar emot och håller på att bearbeta svaret.
RemotingClientSendingMessage-metod Meddelar profileraren att klienten skickar en begäran till servern.
RemotingServerInvocationReturned-metod Meddelar profileraren att processen har anropat en metod som svar på en begäran om anrop av fjärrmetod.
RemotingServerInvocationStarted-metod Meddelar profileraren att processen anropar en metod som svar på en begäran om anrop av fjärrmetod.
RemotingServerReceivingMessage-metod Meddelar profileraren att processen tar emot en fjärrmetodanrops- eller aktiveringsbegäran.
RemotingServerSendingReply-metod Meddelar profileraren att processen har slutfört bearbetningen av en begäran om anrop av fjärrmetoder och håller på att överföra svaret via en kanal.
RootReferences-metod Meddelar profileraren med information om rotreferenser efter skräpinsamling.
RuntimeResumeFinished-metod Meddelar profileraren att körningen har återupptagit alla körningstrådar och har återgått till normal drift.
RuntimeResumeStarted-metod Meddelar profileraren att körningen återupptar alla körningstrådar.
RuntimeSuspendAborted-metod Meddelar profileraren att körningen har avbrutit den körningsavstängning som inträffade.
RuntimeSuspendFinished-metod Meddelar profileraren att körningen har slutfört avstängningen av alla körningstrådar.
RuntimeSuspendStarted-metod Meddelar profileraren att körningen håller på att pausa alla körningstrådar.
RuntimeThreadResumed-metod Meddelar profileraren att den angivna tråden har återupptagits efter paus.
RuntimeThreadSuspended-metod Meddelar profileraren att den angivna tråden har inaktiverats eller håller på att pausas.
Avstängningsmetod Meddelar profileraren att programmet stängs av.
ThreadAssignedToOSThread-metod Meddelar profileraren att en hanterad tråd implementeras med en viss operativsystemtråd (OS).
ThreadCreated-metod Meddelar profileraren att en tråd har skapats.
ThreadDestroyed-metod Meddelar profileraren att en tråd har förstörts.
UnmanagedToManagedTransition-metod Meddelar profileraren att en övergång från ohanterad kod till hanterad kod har inträffat.

Kommentarer

CLR anropar en metod i ICorProfilerCallback gränssnittet (eller ICorProfilerCallback2) för att meddela profileraren när en händelse, som profileraren har prenumererat på, inträffar. Det här är det primära motringningsgränssnittet genom vilket CLR kommunicerar med kodprofileraren.

En kodprofilerare måste implementera metoderna i ICorProfilerCallback gränssnittet. För .NET Framework version 2.0 eller senare måste profileraren också implementera ICorProfilerCallback2 metoderna. Varje metodimplementering måste returnera en HRESULT som har värdet S_OK för lyckade eller E_FAIL vid fel. För närvarande ignorerar CLR DEN HRESULT som returneras av varje återanrop förutom ICorProfilerCallback::ObjectReferences.

I Microsoft Windows-registret måste en kodprofilerare registrera sitt COM-objekt (Component Object Model) som implementerar gränssnitten ICorProfilerCallback och ICorProfilerCallback2 . En kodprofilerare prenumererar på de händelser som den vill ta emot meddelanden för genom att anropa ICorProfilerInfo::SetEventMask. Detta görs vanligtvis i profilerarens implementering av ICorProfilerCallback::Initialize. Profileraren kan sedan ta emot meddelanden från körningen när en händelse är på väg att inträffa eller just har inträffat i en körningsprocess.

Anteckning

Profileraren registrerar ett enda COM-objekt. Om profileraren riktar in sig på .NET Framework version 1.0 eller 1.1 behöver com-objektet bara implementera metoderna ICorProfilerCallbackför . Om det är inriktat på .NET Framework version 2.0 eller senare måste COM-objektet även implementera metoderna ICorProfilerCallback2för .

Krav

Plattformar: Se Systemkrav.

Huvudet: CorProf.idl, CorProf.h

Bibliotek: CorGuids.lib

.NET Framework versioner: Tillgänglig sedan 1.0

Se även