ICorProfilerInfo3 Interface
Biedt methoden die codeprofilers gebruiken om te communiceren met de Common Language Runtime (CLR) om gebeurtenisbewaking te beheren en informatie op te vragen. De ICorProfilerInfo3 interface is een uitbreiding van de interface ICorProfilerInfo2 . Het biedt nieuwe methoden die worden ondersteund in de .NET Framework 4 en latere versies.
Methoden
| Methode | Beschrijving |
|---|---|
| Methode EnumJITedFunctions | Retourneert een enumerator voor alle eerder gecompileerde JIT-functies. |
| Methode EnumModules | Retourneert een enumerator die methoden biedt voor het opeenvolgend herhalen van een verzameling beheerde modules die in de toepassing worden geladen. |
| Methode GetAppDomainsContainingModule | Hiermee haalt u de id's op van de toepassingsdomeinen waarin de opgegeven module is geladen. |
| Methode GetFunctionEnter3Info | Geeft het stackframe en de argumentinformatie van de functie die wordt gerapporteerd aan de profiler door de functie FunctionEnter3WithInfo ; kan alleen worden aangeroepen tijdens het FunctionEnter3WithInfo terugbellen. |
| Methode GetFunctionLeave3Info | Biedt het stackframe en de retourwaarde van de functie die door de functie FunctionLeave3WithInfo aan de profiler wordt gerapporteerd; kan alleen worden aangeroepen tijdens het FunctionLeave3WithInfo terugbellen. |
| Methode GetFunctionTailcall3Info | Biedt het stackframe van de functie die aan de profiler wordt gerapporteerd door de functie FunctionTailcall3WithInfo ; kan alleen worden aangeroepen tijdens het FunctionTailcall3WithInfo terugbellen. |
| Methode GetModuleInfo2 | Op basis van een module-id retourneert de bestandsnaam van de module, de id van de bovenliggende assembly van de module en een bitmasker dat de eigenschappen van de module beschrijft. |
| Methode GetRuntimeInformation | Biedt versie-informatie over de runtime die wordt geprofileerd. |
| Methode GetStringLayout2 | Hiermee haalt u informatie op over de indeling van een tekenreeksobject. |
| Methode GetThreadStaticAddress2 | Hiermee haalt u het adres op van het opgegeven thread-statische veld dat zich in het bereik van de opgegeven thread en het opgegeven toepassingsdomein bevindt. |
| Methode RequestProfilerDetach | Geeft de runtime de opdracht om de profiler los te koppelen. |
| Methode SetEnterLeaveFunctionHooks3 | Hiermee geeft u de door profiler geïmplementeerde functies op die worden aangeroepen op de functies FunctionEnter3, FunctionLeave3 en FunctionTailcall3 . |
| Methode SetEnterLeaveFunctionHooks3WithInfo | Hiermee geeft u de door profiler geïmplementeerde functies op die worden aangeroepen op de hooks FunctionEnter3WithInfo, FunctionLeave3WithInfo en FunctionTailcall3WithInfo van beheerde functies. |
| Methode SetFunctionIDMapper2 | Hiermee geeft u de door profiler geïmplementeerde functie op die wordt aangeroepen om waarden toe te wijzen FunctionID aan alternatieve waarden, die worden doorgegeven aan de haken voor het invoeren/verlaten van de functie van de profiler. Deze methode breidt ICorProfilerInfo::SetFunctionIDMapper uit met een parameter die profilers kunnen gebruiken om ondubbelzinnig te zijn tussen runtimes. |
Opmerkingen
De CLR implementeert de methoden van de ICorProfilerInfo3 interface met behulp van het freethread-model. Elke methode retourneert een HRESULT om succes of mislukking aan te geven. Zie het bestand CorError.h voor een lijst met mogelijke retourcodes.
De CLR geeft een ICorProfilerInfo3 interface door aan elke code profiler tijdens de initialisatie, met behulp van de implementatie van de profiler van de methode ICorProfilerCallback::Initialize of ICorProfilerCallback3::InitializeForAttach . Een codeprofiel kan vervolgens de ICorProfilerInfo3 methoden aanroepen om informatie op te halen over beheerde code die wordt uitgevoerd onder beheer van de CLR.
Vereisten
Platforms: Zie Systeemvereisten.
Header: CorProf.idl, CorProf.h
Bibliotheek: CorGuids.lib
.NET Framework versies: beschikbaar sinds 4
