ICorProfilerInfo3-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. 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

Weitere Informationen