Gränssnitt för ICorProfilerInfo3
Innehåller metoder som kodprofilerare använder för att kommunicera med CLR (Common Language Runtime) för att kontrollera händelseövervakning och begära information. Gränssnittet ICorProfilerInfo3 är ett tillägg till gränssnittet ICorProfilerInfo2 . Den innehåller nya metoder som stöds i .NET Framework 4 och senare versioner.
Metoder
| Metod | Beskrivning |
|---|---|
| EnumJITedFunctions-metod | Returnerar en uppräknare för alla tidigare JIT-kompilerade funktioner. |
| EnumModules-metod | Returnerar en uppräknare som tillhandahåller metoder för att sekventiellt iterera genom en samling hanterade moduler som läses in i programmet. |
| GetAppDomainsContainingModule-metod | Hämtar identifierarna för de programdomäner där den angivna modulen har lästs in. |
| GetFunctionEnter3Info-metod | Innehåller stackram- och argumentinformation för funktionen som rapporteras till profileraren av funktionen FunctionEnter3WithInfo . kan bara anropas under återanropet FunctionEnter3WithInfo . |
| GetFunctionLeave3Info-metod | Tillhandahåller stackramen och returvärdet för funktionen som rapporteras till profileraren av funktionsfunktionen FunctionLeave3WithInfo . kan bara anropas under återanropet FunctionLeave3WithInfo . |
| GetFunctionTailcall3Info-metod | Tillhandahåller stackramen för funktionen som rapporteras till profileraren av funktionen FunctionTailcall3WithInfo . kan bara anropas under återanropet FunctionTailcall3WithInfo . |
| GetModuleInfo2-metod | Givet ett modul-ID returnerar filnamnet för modulen, ID:t för modulens överordnade sammansättning och en bitmask som beskriver egenskaperna för modulen. |
| GetRuntimeInformation-metod | Innehåller versionsinformation om den körning som profileras. |
| GetStringLayout2-metod | Hämtar information om layouten för ett strängobjekt. |
| GetThreadStaticAddress2-metod | Hämtar adressen för det angivna trådstatiska fältet som finns i omfånget för den angivna tråden och programdomänen. |
| RequestProfilerDetach-metod | Instruerar körningen att koppla från profileraren. |
| SetEnterLeaveFunctionHooks3-metod | Anger profiler-implementerade funktioner som ska anropas för funktionerna FunctionEnter3, FunctionLeave3 och FunctionTailcall3 . |
| SetEnterLeaveFunctionHooks3WithInfo, metod | Anger profiler-implementerade funktioner som ska anropas på hookarna FunctionEnter3WithInfo, FunctionLeave3WithInfo och FunctionTailcall3WithInfo för hanterade funktioner. |
| SetFunctionIDMapper2-metod | Anger den profilerarimplementerad funktion som ska anropas för att mappa FunctionID värden till alternativa värden, som skickas till profilerarens funktionsinmatnings-/utgångskrokar. Den här metoden utökar ICorProfilerInfo::SetFunctionIDMapper med en parameter som profilerare kan använda för att skilja mellan körningar. |
Kommentarer
CLR implementerar gränssnittsmetoderna ICorProfilerInfo3 med hjälp av den fritrådade modellen. Varje metod returnerar en HRESULT för att indikera lyckade eller misslyckade försök. En lista över möjliga returkoder finns i filen CorError.h.
CLR skickar ett ICorProfilerInfo3 gränssnitt till varje kodprofilerare under initieringen med hjälp av profilerarens implementering av metoden ICorProfilerCallback::Initialize eller ICorProfilerCallback3::InitializeForAttach . En kodprofilerare kan sedan anropa ICorProfilerInfo3 metoderna för att hämta information om hanterad kod som körs under kontroll av CLR.
Krav
Plattformar: Se Systemkrav.
Huvudet: CorProf.idl, CorProf.h
Bibliotek: CorGuids.lib
.NET Framework versioner: Tillgänglig sedan 4
