ICorProfilerInfo-Schnittstelle
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 einesObjekts 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.
