ICorProfilerInfo3-Schnittstelle
Stellt Methoden bereit, die Codeprofiler für die Kommunikation mit der Common Language Runtime (CLR) verwenden, um die Ereignisüberwachung zu steuern und Informationen anzufordern. Die ICorProfilerInfo3-Schnittstelle ist eine Erweiterung der ICorProfilerInfo2-Schnittstelle. Sie stellt neue Methoden bereit, die in .NET Framework, Version 4 und höheren Versionen unterstützt werden.
Methoden
Methode |
Beschreibungen |
|---|---|
Gibt einen Enumerator für alle zuvor mit JIT kompilierten Funktionen zurück. |
|
Gibt einen Enumerator zurück, der Methoden bereitstellt, um eine Auflistung verwalteter Module sequenziell zu durchlaufen, die in die Anwendung geladen werden. |
|
Ruft die Bezeichner der Anwendungsdomänen ab, in die das angegebene Modul geladen wurde. |
|
Stellt den Stapelrahmen und die Argumentinformationen der Funktion bereit, die dem Profiler von der FunctionEnter3WithInfo-Funktion gemeldet werden. Kann nur während des FunctionEnter3WithInfo-Rückrufs aufgerufen werden. |
|
Stellt den Stapelrahmen und den Rückgabewert der Funktion bereit, die dem Profiler von der FunctionLeave3WithInfo-Funktion gemeldet werden. Kann nur während des FunctionLeave3WithInfo-Rückrufs aufgerufen werden. |
|
Stellt den Stapelrahmen und die Argumentinformationen der Funktion bereit, die dem Profiler von der FunctionTailcall3WithInfo-Funktion gemeldet werden. Kann nur während des FunctionTailcall3WithInfo-Rückrufs aufgerufen werden. |
|
Gibt bei vorhandener Modul-ID den Dateinamen des Moduls und die ID der übergeordneten Assembly des Moduls sowie eine Bitmaske zurück, die die Moduleigenschaften beschreibt. |
|
Stellt Versionsinformationen über die Laufzeit bereit, deren Profil erstellt wird. |
|
Ruft Informationen über das Layout eines Zeichenfolgenobjekts ab. |
|
Ruft die Adresse des angegebenen threadstatischen Felds ab, das sich im Gültigkeitsbereich des angegebenen Threads und der angegebenen Anwendungsdomäne befindet. |
|
Weist die Laufzeit an, den Profiler zu trennen. |
|
Gibt die Profiler-implementierten Funktionen an, die für die Funktionen FunctionEnter3, FunctionLeave3 und FunctionTailcall3 aufgerufen werden. |
|
ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo-Methode |
Gibt die Profiler-implementierten Funktionen an, die für die Hooks verwalteter Funktionen FunctionEnter3WithInfo, FunctionLeave3WithInfo, und FunctionTailcall3WithInfo aufgerufen werden. |
Gibt die vom Profiler implementierte Funktion an, die aufgerufen wird, um FunctionID-Werte alternativen Werten zuzuordnen, die an die entry/exit-Hooks der Profilerfunktion übergeben werden. Diese Methode erweitert ICorProfilerInfo::SetFunctionIDMapper um einen Parameter, mit dem Profiler Mehrdeutigkeiten zwischen Laufzeiten auflösen können. |
Hinweise
Die CLR implementiert die Methoden der ICorProfilerInfo3-Schnittstelle mithilfe des Freethreadmodells. Jede Methode gibt ein HRESULT zurück, um Erfolg oder Fehler anzugeben. Eine Liste möglicher Rückgabecodes finden Sie in der Datei CorError.h.
Die CLR übergibt eine ICorProfilerInfo3-Schnittstelle an jeden Codeprofiler während der Initialisierung mit der Implementierung der ICorProfilerCallback::Initialize-Methode oder ICorProfilerCallback3::InitializeForAttach-Methode des Profilers. Ein Codeprofiler kann dann die ICorProfilerInfo3-Methoden aufrufen, um Informationen zu verwaltetem Code abzurufen, dessen Ausführung von der CLR gesteuert wird.
Informationen zu AppDomainID-Werten und FunctionID-Werten finden Sie unter Profilerstellungs- und Laufzeitbenachrichtigungs-IDs.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: CorProf.idl, CorProf.h
Bibliothek: CorGuids.lib
**.NET Framework-Versionen: ** 4
Siehe auch
Referenz
ICorProfilerInfo-Schnittstelle