ICorProfilerInfo3-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. Die ICorProfilerInfo3-Schnittstelle ist eine Erweiterung der ICorProfilerInfo2-Schnittstelle. Sie stellt neue Methoden bereit, die ab der .NET Framework-Version 4 unterstützt werden.
Methoden
| Methode | BESCHREIBUNG |
|---|---|
| EnumJITedFunctions-Methode | Gibt einen Enumerator für alle zuvor mit JIT kompilierten Funktionen zurück. |
| EnumModules-Methode | Gibt einen Enumerator zurück, der Methoden zum sequenziellen Iterieren durch eine Auflistung von verwalteten Modulen bereitstellt, die in die Anwendung geladen werden. |
| GetAppDomainsContainingModule-Methode | Ruft die Bezeichner der Anwendungsdomänen ab, in denen das angegebene Modul geladen wurde. |
| GetFunctionEnter3Info-Methode | Stellt den Stapelrahmen und die Argumentinformationen der Funktion bereit, die dem Profiler von der FunctionEnter3WithInfo-Funktion gemeldet wird. Kann nur während des FunctionEnter3WithInfo-Rückrufs aufgerufen werden. |
| GetFunctionLeave3Info-Methode | Stellt den Stapelrahmen und den Rückgabewert der Funktion bereit, die dem Profiler von der FunctionEnter3WithInfo-Funktion gemeldet wird. Kann nur während des FunctionLeave3WithInfo-Rückrufs aufgerufen werden. |
| GetFunctionTailcall3Info-Methode | Stellt den Stapelrahmen der Funktion bereit, die dem Profiler von der FunctionTailcall3WithInfo-Funktion gemeldet wird. Kann nur während des FunctionTailcall3WithInfo-Rückrufs aufgerufen werden. |
| GetModuleInfo2-Methode | Gibt bei Angabe einer Modul-ID den Dateinamen des Moduls, die ID der übergeordneten Assembly des Moduls und eine Bitmaske zurück, die die Eigenschaften des Moduls beschreibt. |
| GetRuntimeInformation-Methode | Stellt die Versionsinformationen zum Laufzeitmodul bereit, für das ein Profil erstellt wird. |
| GetStringLayout2-Methode | Ruft Informationen zum Layout eines Zeichenfolgenobjekts ab. |
| GetThreadStaticAddress2-Methode | Ruft die Adresse des angegebenen threadstatischen Felds im Bereich des angegebenen Threads und der Anwendungsdomäne ab. |
| RequestProfilerDetach-Methode | Weist das Laufzeitmodul an, den Profiler zu trennen. |
| SetEnterLeaveFunctionHooks3-Methode | Gibt die vom Profiler implementierten Funktionen an, die für die Funktionen FunctionEnter3, FunctionLeave3 und FunctionTailcall3 aufgerufen werden. |
| SetEnterLeaveFunctionHooks3WithInfo-Methode | Gibt die vom Profiler implementierten Funktionen an, die für die Hooks FunctionEnter3WithInfo, FunctionLeave3WithInfo und FunctionTailcall3WithInfo von verwalteten Funktionen aufgerufen werden. |
| SetFunctionIDMapper2-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. Diese Methode erweitert ICorProfilerInfo::SetFunctionIDMapper um einen Parameter, den Profiler ggf. verwenden können, um Runtimes eindeutig zu machen. |
Bemerkungen
Die CLR implementiert die Methoden der ICorProfilerInfo3-Schnittstelle mithilfe des Freethreadmodells. 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".
Die CLR übergibt während der Initialisierung mithilfe der Implementierung der ICorProfilerCallback::Initialize- oder ICorProfilerCallback3::InitializeForAttach-Methode des Profilers eine ICorProfilerInfo3-Schnittstelle an jeden Codeprofiler. Ein Codeprofiler kann dann die ICorProfilerInfo3-Methoden 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 Version 4 verfügbar
