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