Delen via

ICorProfilerInfo Interface

  • Artikel

Biedt methoden voor gebruik door code profilers om te communiceren met de Common Language Runtime (CLR) voor het beheren van gebeurtenisbewaking en aanvraaggegevens.

Notitie

Elke methode in de ICorProfilerInfo interface retourneert een HRESULT om aan te geven dat deze is geslaagd of mislukt. Zie CorError.h voor een lijst met mogelijke retourcodes.

Methoden

Wijze Description
Methode BeginInprocDebugging Initialiseert ondersteuning voor foutopsporing in proces. Deze methode is verouderd in .NET Framework versie 2.0.
Methode EndInprocDebugging Sluit een in-process foutopsporingssessie af. Deze methode is verouderd in .NET Framework versie 2.0.
Methode ForceGC Dwingt garbagecollection op te treden binnen de runtime.
Methode GetAppDomainInfo Hiermee wordt informatie opgehaald over het opgegeven toepassingsdomein.
Methode GetAssemblyInfo Hiermee wordt informatie opgehaald over de opgegeven assembly.
Methode GetClassFromObject Haalt de ClassID van een

object, gegeven zijn ObjectID.
Methode GetClassFromToken Hiermee haalt u de id van de klasse op, op basis van het metagegevenstoken. Deze methode is verouderd in .NET Framework versie 2.0. Gebruik in plaats daarvan de methode ICorProfilerInfo2::GetClassFromTokenAndTypeArgs .
Methode GetClassIDInfo Hiermee haalt u de bovenliggende module en het metagegevenstoken voor de opgegeven klasse op.
Methode GetCodeInfo Hiermee haalt u de mate op van systeemeigen code die is gekoppeld aan de opgegeven functie-id. Deze methode is verouderd. Gebruik in plaats daarvan de methode ICorProfilerInfo2::GetCodeInfo2 .
Methode GetCurrentThreadID Hiermee haalt u de id van de huidige thread op als het een beheerde thread is.
Methode GetEventMask Hiermee haalt u de huidige gebeurteniscategorieën op waarvoor de profiler gebeurtenismeldingen van de CLR wil ontvangen.
Methode GetFunctionFromIP Kaarten een instructiewijzer voor beheerde code naar een FunctionID.
Methode GetFunctionFromToken Hiermee haalt u de id van een functie op. Deze methode is verouderd in .NET Framework versie 2.0. Gebruik in plaats daarvan de methode ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs .
Methode GetFunctionInfo Hiermee haalt u het bovenliggende klasse- en metagegevenstoken voor de opgegeven functie op.
Methode GetHandleFromThread Kaarten de id van een thread naar een Win32-threadgreep.
Methode GetILFunctionBody Hiermee haalt u een aanwijzer op naar de hoofdtekst van een methode in algemene tussenliggende taalcode (CIL), beginnend bij de header.
Methode GetILFunctionBodyAllocator Hiermee haalt u een interface op die een methode biedt om geheugen toe te wijzen die moet worden gebruikt voor het wisselen van de hoofdtekst van een methode in CIL-code.
Methode GetILToNativeMapping Hiermee haalt u een kaart op van CIL-offsets naar systeemeigen offsets voor de code in de opgegeven functie.
Methode GetInprocInspectionInterface Hiermee haalt u een object op dat kan worden opgevraagd voor een ICorDebugProcess-interface. Deze methode is verouderd in .NET Framework versie 2.0.
Methode GetInprocInspectionIThisThread Hiermee haalt u een object op dat kan worden opgevraagd voor de ICorDebugThread-interface. Deze methode is verouderd in .NET Framework versie 2.0.
Methode GetModuleInfo Met een module-id wordt de bestandsnaam van de module en de id van de bovenliggende assembly van de module geretourneerd.
Methode GetModuleMetaData Hiermee haalt u een exemplaar van de metagegevensinterface op dat is toegewezen aan de opgegeven module.
Methode GetObjectSize Hiermee wordt de grootte van een opgegeven object opgehaald.
Methode GetThreadContext Hiermee haalt u de contextidentiteit op die momenteel is gekoppeld aan de opgegeven thread.
Methode GetThreadInfo Hiermee haalt u de huidige Win32-threadidentiteit op voor de opgegeven thread.
Methode GetTokenAndMetadataFromFunction Hiermee haalt u het metagegevenstoken en een exemplaar van de metagegevensinterface op die kan worden gebruikt voor het token voor de opgegeven functie.
Methode IsArrayClass Bepaalt of de opgegeven klasse een matrixklasse is.
Methode SetEnterLeaveFunctionHooks Hiermee geeft u profiler geïmplementeerde functies worden aangeroepen op 'enter', 'leave' en 'tailcall' hooks van beheerde functies.
Methode SetEventMask Hiermee stelt u een waarde in waarmee de typen gebeurtenissen worden opgegeven waarvoor de profiler een melding van de CLR wil ontvangen.
Methode SetFunctionIDMapper Hiermee geeft u de profiler geïmplementeerde functie die wordt aangeroepen om waarden toe te wijzen FunctionID aan alternatieve waarden, die worden doorgegeven aan de functie-invoer-/eindhaken van de profiler.
Methode SetFunctionReJIT Niet geïmplementeerd. Niet gebruiken.
Methode SetILFunctionBody Vervangt de hoofdtekst van de opgegeven functie in de opgegeven module.
Methode SetILInstrumentedCodeMap Hiermee geeft u op hoe de verschuivingen van de oorspronkelijke CIL van een OPGEGEVEN functie worden toegewezen aan de nieuwe verschuivingen van de door de profiler gewijzigde CIL van de functie.

Opmerkingen

Een profiler roept een methode aan in de ICorProfilerInfo interface om te communiceren met de CLR om gebeurtenisbewaking en aanvraaggegevens te beheren.

De methoden van de ICorProfilerInfo interface worden door de CLR geïmplementeerd met behulp van het gratis threaded model. Elke methode retourneert een HRESULT om aan te geven dat deze is geslaagd of mislukt. Zie CorError.h voor een lijst met mogelijke retourcodes.

De CLR wordt doorgegeven via de profiler-implementatie van ICorProfilerCallback::Initialize, een ICorProfilerInfo interface voor elke code profiler tijdens de initialisatie. Een code profiler kan vervolgens methoden van de ICorProfilerInfo interface aanroepen om informatie op te halen over beheerde code die wordt uitgevoerd onder het beheer van de CLR.

Vereisten

Platformen: Zie Systeemvereisten.

Koptekst: CorProf.idl, CorProf.h

Bibliotheek: CorGuids.lib

.NET Framework-versies: beschikbaar sinds 2.0

Zie ook