Dela via

ICorProfilerCallback2-gränssnitt

  • Artikel

Innehåller metoder som används av CLR (Common Language Runtime) för att meddela en kodprofilerare när händelserna som profileraren har prenumererat på inträffar. Gränssnittet ICorProfilerCallback2 är ett tillägg till ICorProfilerCallback-gränssnittet . Det innebär att det ger nya återanrop som introduceras i .NET Framework version 2.0.

Anteckning

Varje metodimplementering måste returnera en HRESULT med 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.

Metoder

Metod Beskrivning
FinalizeableObjectQueued-metod Meddelar kodprofileraren att ett objekt med en finaliserare har placerats i kö till finaliserartråden för körning av metoden Finalize .
GarbageCollectionFinished-metod Meddelar profileraren att en skräpinsamling har slutförts och att alla återanrop för skräpinsamling har utfärdats för den.
GarbageCollectionStarted-metod Meddelar kodprofileraren att en skräpinsamling har startats.
HandleCreated-metod Meddelar kodprofileraren att ett skräpinsamlingshandtag har skapats.
HandleDestroyed-metod Meddelar kodprofileraren att ett skräpinsamlingshandtag har förstörts.
RootReferences2-metod Meddelar profileraren om rotreferenser efter att en skräpinsamling har inträffat. Den här metoden är ett tillägg till metoden ICorProfilerCallback::RootReferences .
SurvivingReferences-metod Meddelar profileraren om objektreferenser som har överlevt en skräpinsamling.
ThreadNameChanged-metod Meddelar kodprofileraren att namnet på en tråd har ändrats.

Kommentarer

CLR anropar en metod i ICorProfilerCallback (eller ICorProfilerCallback2) gränssnittet för att meddela profileraren när en händelse, som profileraren hade 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 2.0 och senare versioner måste profileraren också implementera ICorProfilerCallback2 metoderna. Varje metodimplementering måste returnera en HRESULT med 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.

En kodprofilerare måste registrera sig i Microsoft Windows-registret, dess COM-objekt 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 är inriktad på .NET Framework version 1.0 eller 1.1 behöver det COM-objektet bara implementera metoderna ICorProfilerCallbackför . Om det är inriktat på .NET Framework version 2.0 och 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 2.0

Se även