ICorProfilerInfo2 Interface
Biedt methoden die code profilers gebruiken om te communiceren met de Common Language Runtime (CLR) voor het controleren van gebeurtenissen en het aanvragen van informatie. De ICorProfilerInfo2 interface is een uitbreiding van de interface ICorProfilerInfo . Dat wil dat het nieuwe methoden biedt die worden ondersteund in de .NET Framework versie 2.0 en latere versies.
Methoden
| Methode | Beschrijving |
|---|---|
| Methode DoStackSnapshot | Doorloopt de stack van de opgegeven thread om beheerde aanroepframes te rapporteren aan de profiler. |
| Methode EnumModuleFrozenObjects | Hiermee haalt u een enumerator op waarmee de bevroren objecten in de opgegeven module kunnen worden herhaald. |
| Methode GetAppDomainStaticAddress | Hiermee haalt u het adres op van het opgegeven statische toepassingsdomeinveld dat zich binnen het bereik van het opgegeven toepassingsdomein bevindt. |
| Methode GetArrayObjectInfo | Hiermee haalt u gedetailleerde informatie op over een matrixobject. |
| Methode GetBoxClassLayout | Hiermee haalt u informatie op over de klasse-indeling voor een opgegeven waardetype dat in een vak wordt weergegeven. |
| Methode GetClassFromTokenAndTypeArgs | Hiermee haalt u de ClassID van een type op met behulp van het opgegeven metagegevenstoken en de ClassID waarden van elk typeargumenten. |
| Methode GetClassIDInfo2 | Haalt de bovenliggende module van de opgegeven algemene klasse op, het metagegevenstoken voor de klasse, de ClassID van de bovenliggende klasse en de ClassID voor elk typeargument, indien aanwezig, van de klasse. |
| Methode GetClassLayout | Hiermee haalt u informatie op over de indeling, in het geheugen, van de velden die zijn gedefinieerd door de opgegeven klasse. Dat wil dat deze methode de verschuivingen van de velden van de klasse ophaalt. |
| Methode GetCodeInfo2 | Hiermee haalt u de gebieden van systeemeigen code op die zijn gekoppeld aan de opgegeven FunctionID. |
| Methode GetContextStaticAddress | Hiermee haalt u het adres op van het opgegeven contextstatische veld dat zich binnen het bereik van de opgegeven context bevindt. |
| Methode GetFunctionFromTokenAndTypeArgs | Hiermee haalt u de FunctionID van een functie op met behulp van het opgegeven metagegevenstoken, dat klasse en ClassID waarden van elk type argumenten bevat. |
| Methode GetFunctionInfo2 | Hiermee haalt u de bovenliggende klasse, het metagegevenstoken en de ClassID van elk typeargument op, indien aanwezig, van een functie. |
| Methode GetGenerationBounds | Hiermee haalt u de geheugenregio's (de segmenten van de heap) op waaruit de generaties van de garbage-collected heap bestaan. |
| Methode GetNotifiedExceptionClauseInfo | Hiermee haalt u de systeemeigen adres- en framegegevens op voor de uitzonderingscomponent (catch//finallyfilter) die op het punt staat te worden uitgevoerd of die net is uitgevoerd. |
| Methode GetObjectGeneration | Hiermee haalt u het segment van de heap op dat het opgegeven object bevat. |
| Methode GetRVAStaticAddress | Hiermee haalt u het adres op van het opgegeven relatieve virtuele adres (RVA)-statische veld. |
| Methode GetStaticFieldInfo | Hiermee haalt u het bereik op waarin het opgegeven veld statisch is. |
| Methode GetStringLayout | Hiermee haalt u informatie op over de indeling van een tekenreeksobject. |
| Methode GetThreadAppDomain | Hiermee haalt u de id op van het toepassingsdomein waarin de opgegeven thread momenteel code uitvoert. |
| Methode GetThreadStaticAddress | Hiermee haalt u het adres op van het opgegeven thread-statische veld dat zich in het bereik van de opgegeven thread bevindt. |
| Methode SetEnterLeaveFunctionHooks2 | Hiermee geeft u door profiler geïmplementeerde functies op die moeten worden aangeroepen op 'enter', 'leave' en 'tailcall' hooks van beheerde functies. |
Opmerkingen
Een profiler roept een methode aan in de ICorProfilerInfo2 interface om te communiceren met de CLR om gebeurtenisbewaking te beheren en informatie aan te vragen.
De methoden van de ICorProfilerInfo2 interface worden geïmplementeerd door de CLR met behulp van het vrije thread-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 ICorProfilerInfo2 interface door aan elke code profiler tijdens de initialisatie, met behulp van de implementatie van ICorProfilerCallback::Initialize van de profiler. Een codeprofiler kan vervolgens methoden van de ICorProfilerInfo2 interface 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 2.0
