Freigeben über

ICorProfilerInfo2-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 ICorProfilerInfo2-Schnittstelle ist eine Erweiterung der ICorProfilerInfo2-Schnittstelle. Das heißt, es werden neue Methoden bereitgestellt, die ab der .NET Framework-Version 2.0 unterstützt werden.

Methoden

Methode BESCHREIBUNG
DoStackSnapshot-Methode Durchläuft den Stapel des angegebenen Threads, um dem Profiler verwaltete Aufrufframes zu melden.
EnumModuleFrozenObjects-Methode Ruft einen Enumerator ab, der die Iteration über die fixierten Objekte im angegebenen Modul zulässt.
GetAppDomainStaticAddress-Methode Ruft die Adresse des angegebenen für die Anwendungsdomäne statischen Felds im Bereich der angegebenen Anwendungsdomäne ab.
GetArrayObjectInfo-Methode Ruft detaillierte Informationen zu einem Arrayobjekt ab.
GetBoxClassLayout-Methode Ruft Informationen zum Klassenlayout für einen angegebenen Werttyp ab, der geschachtelt wird.
GetClassFromTokenAndTypeArgs-Methode Ruft die ClassID eines Typs mithilfe des angegebenen Metadatentokens und der ClassID-Werte beliebiger Typargumente ab.
GetClassIDInfo2-Methode Ruft das übergeordnete Modul der angegebenen generischen Klasse, das Metadatentoken der Klasse, die ClassID von deren übergeordneter Klasse und die ClassID für jedes Typargument der Klasse ab, falls vorhanden.
GetClassLayout-Methode Ruft aus dem Arbeitsspeicher Informationen über das Layout der Felder ab, die durch die angegebene Klasse definiert sind . Das heißt, diese Methode ruft die Offsets der Felder der Klasse ab.
GetCodeInfo2-Methode Ruft die Wertebereiche von nativem Code ab, der der angegebenen FunctionID zugeordnet ist.
GetContextStaticAddress-Methode Ruft die Adresse des angegebenen, für den Kontext statischen Felds ab, das sich im Bereich des angegebenen Kontexts befindet.
GetFunctionFromTokenAndTypeArgs-Methode Ruft die FunctionID einer Funktion mithilfe des angegebenen Metadatentokens mit der Klasse und ClassID-Werte beliebiger Typargumente ab.
GetFunctionInfo2-Methode Ruft die übergeordnete Klasse, das Metadatentoken und die ClassID jedes Typarguments einer Funktion ab, falls vorhanden.
GetGenerationBounds-Methode Ruft die Arbeitsspeicherbereiche (die Segmente des Heaps) ab, aus denen die Generationen des Garbage Collection-Heaps bestehen.
GetNotifiedExceptionClauseInfo-Methode Ruft die native Adresse und Frameinformationen für die Ausnahmeklausel (catch/finally/filter) ab, die gerade ausgeführt werden soll oder gerade ausgeführt wurde.
GetObjectGeneration-Methode Ruft das Segment des Heaps mit dem angegebenen Objekt ab.
GetRVAStaticAddress-Methode Ruft die Adresse des angegebenen statischen Felds für die relative virtuelle Adresse (RVA) ab.
GetStaticFieldInfo-Methode Ruft den Bereich ab, in dem das angegebene Feld statisch ist.
GetStringLayout-Methode Ruft Informationen zum Layout eines Zeichenfolgenobjekts ab.
GetThreadAppDomain-Methode Ruft die ID der Anwendungsdomäne ab, in der der angegebene Thread derzeit Code ausführt.
GetThreadStaticAddress-Methode Ruft die Adresse des angegebenen für den Thread statischen Felds im Bereich des angegebenen Threads ab.
SetEnterLeaveFunctionHooks2-Methode Gibt die von Profilern implementierten Funktionen an, die für die Hooks „enter“, „leave“ und „tailcall“ von verwalteten Funktionen aufgerufen werden sollen.

Bemerkungen

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

Die Methoden der ICorProfilerInfo2-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".

Die CLR übergibt während der Initialisierung eine ICorProfilerInfo2-Schnittstelle an jeden Codeprofiler, wobei die Implementierung des Profilers von ICorProfilerCallback::Initialize verwendet wird. Ein Codeprofiler kann dann Methoden der ICorProfilerInfo2-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