ICorProfilerInfo-Schnittstelle

  • Artikel

Stellt Methoden bereit, mit denen Codeprofiler mit der CLR (Common Language Runtime) kommunizieren können, um die Ereignisüberwachung zu steuern und Informationen anzufordern.

Hinweis

Jede Methode in der ICorProfilerInfo-Schnittstelle gibt ein HRESULT zurück, um anzugeben, ob der Vorgang erfolgreich oder fehlerhaft war. Eine Liste möglicher Rückgabecodes finden Sie in der Datei "CorError.h".

Methoden

Methode Beschreibung
BeginInprocDebugging-Methode Initialisiert die Unterstützung für das In-Process-Debuggen. Diese Methode ist in .NET Framework, Version 2.0, veraltet.
EndInprocDebugging-Methode Fährt eine In-Process-Debugsitzung herunter. Diese Methode ist in .NET Framework, Version 2.0, veraltet.
ForceGC-Methode Erzwingt die Garbage Collection innerhalb der Runtime.
GetAppDomainInfo-Methode Ruft Informationen zur angegebenen Anwendungsdomäne ab.
GetAssemblyInfo-Methode Ruft Informationen zur angegebenen Assembly ab.
GetClassFromObject-Methode Ruft die ClassID eines

Objekts anhand seiner ObjectID ab.
GetClassFromToken-Methode Ruft anhand des Metadatentokens die ID der Klasse ab. Diese Methode ist in .NET Framework, Version 2.0, veraltet. Verwenden Sie stattdessen die ICorProfilerInfo2::GetClassFromTokenAndTypeArgs-Methode.
GetClassIDInfo-Methode Ruft das übergeordnete Modul und das Metadatentoken für die angegebene Klasse ab.
GetCodeInfo-Methode Ruft den Wertebereich des nativen Codes ab, der der angegebenen Funktions-ID zugeordnet ist. Diese Methode ist veraltet. Verwenden Sie stattdessen die ICorProfilerInfo2::GetCodeInfo2-Methode.
GetCurrentThreadID-Methode Ruft die ID des aktuellen Threads ab, wenn es sich um einen verwalteten Thread handelt.
GetEventMask-Methode Ruft die aktuellen Ereigniskategorien ab, für die der Profiler Ereignisbenachrichtigungen von der CLR empfangen soll.
GetFunctionFromIP-Methode Ordnet einer FunctionID einen Anweisungszeiger für verwalteten Code zu.
GetFunctionFromToken-Methode Ruft die ID einer Funktion ab. Diese Methode ist in .NET Framework, Version 2.0, veraltet. Verwenden Sie stattdessen die ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs-Methode.
GetFunctionInfo-Methode Ruft die übergeordnete Klasse und das Metadatentoken für die angegebene Funktion ab.
GetHandleFromThread-Methode Ordnet die ID eines Threads einem Win32-Threadhandle zu.
GetILFunctionBody-Methode Ruft einen Zeiger auf den Textkörper einer Methode in CIL-Code (Common Intermediate Language) ab, beginnend mit der Kopfzeile.
GetILFunctionBodyAllocator-Methode Ruft eine Schnittstelle ab, die eine Methode zum Zuweisen von Arbeitsspeicher zum Austauschen des Textkörpers einer Methode im CIL-Code bereitstellt.
GetILToNativeMapping-Methode Ruft eine Zuordnung von CIL-Offsets zu systemeigenen Offsets für den Code ab, der in der angegebenen Funktion enthalten ist.
GetInprocInspectionInterface-Methode Ruft ein Objekt ab, das nach einer ICorDebugProcess-Schnittstelle abgefragt werden kann. Diese Methode ist in .NET Framework, Version 2.0, veraltet.
GetInprocInspectionIThisThread-Methode Ruft ein Objekt ab, das nach der ICorDebugThread-Schnittstelle abgefragt werden kann. Diese Methode ist in .NET Framework, Version 2.0, veraltet.
GetModuleInfo-Methode Gibt für die übergebene Modul-ID den Dateinamen des Moduls und die ID der übergeordneten Assembly des Moduls zurück.
GetModuleMetaData-Methode Ruft eine Metadatenschnittstelleninstanz ab, die dem angegebenen Modul zugeordnet ist.
GetObjectSize-Methode Ruft die Größe eines angegebenen Objekts ab.
GetThreadContext-Methode Ruft die Kontextidentität ab, die dem angegebenen Thread derzeit zugeordnet ist.
GetThreadInfo-Methode Ruft die aktuelle Win32-Threadidentität für den angegebenen Thread ab.
GetTokenAndMetadataFromFunction-Methode Ruft das Metadatentoken und eine Instanz der Metadatenschnittstelle ab, die für das Token für die angegebene Funktion verwendet werden kann.
IsArrayClass-Methode Bestimmt, ob es sich bei der angegebenen Klasse um eine Arrayklasse handelt.
SetEnterLeaveFunctionHooks-Methode Gibt die von Profilern implementierten Funktionen an, die für die Hooks „enter“, „leave“ und „tailcall“ von verwalteten Funktionen aufgerufen werden sollen.
SetEventMask-Methode Legt einen Wert fest, der die Ereignistypen angibt, für die der Profiler Benachrichtigungen von der CLR empfangen soll.
SetFunctionIDMapper-Methode Gibt die vom Profiler implementierte Funktion an, die aufgerufen wird, um die FunctionID-Werte alternativen Werten zuzuordnen, die an die Funktionseinstiegs-/-exithooks des Profilers übergeben werden.
SetFunctionReJIT-Methode Nicht implementiert. Darf nicht verwendet werden.
SetILFunctionBody-Methode Ersetzt den Text der angegebenen Funktion im angegebenen Modul.
SetILInstrumentedCodeMap-Methode Gibt an, wie die Offsets der ursprünglichen CIL-Zuordnung einer angegebenen Funktion den neuen Offsets des profiler-modified CIL der Funktion zugeordnet werden.

Hinweise

Ein Profiler ruft eine Methode in der ICorProfilerInfo-Schnittstelle auf, um mit der CLR so zu kommunizieren, dass die Ereignisüberwachung gesteuert und Informationen angefordert werden.

Die Methoden der ICorProfilerInfo-Schnittstelle werden von der CLR unter Verwendung des Freethreaded-Modells implementiert. Jede Methode gibt ein HRESULT zurück, um einen Erfolg oder einen Fehler anzugeben. Eine Liste möglicher Rückgabecodes finden Sie in der Datei "CorError.h".

Während der Initialisierung übergibt die CLR über die Profilerimplementierung von ICorProfilerCallback::Initialize eine ICorProfilerInfo-Schnittstelle an jeden Codeprofiler. Ein Codeprofiler kann dann Methoden der ICorProfilerInfo-Schnittstelle aufrufen, um Informationen zu verwaltetem Code abzurufen, der unter der Kontrolle der CLR ausgeführt wird.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch