ICorProfilerInfo-Schnittstelle

Stellt Methoden bereit, mit denen Codeprofiler mit der Common Language Runtime (CLR) kommunizieren können, um die Ereignisüberwachung zu steuern und Informationen anzufordern.

Hinweis
Jede Methode in der ICorProfilerInfo-Schnittstelle gibt HRESULT zurück, um Erfolg oder Fehler anzugeben.Eine Liste möglicher Rückgabecodes finden Sie in CorError.h.

Methoden

Methode	Beschreibungen
ICorProfilerInfo::BeginInprocDebugging-Methode	Initialisiert prozessinterne Debugunterstützung. Diese Methode ist in .NET Framework, Version 2.0, veraltet.
ICorProfilerInfo::EndInprocDebugging-Methode	Schließt eine prozessinterne Debugsitzung. Diese Methode ist in .NET Framework, Version 2.0, veraltet.
ICorProfilerInfo::ForceGC-Methode	Erzwingt eine Garbage Collection innerhalb der Laufzeit.
ICorProfilerInfo::GetAppDomainInfo-Methode	Ruft Informationen zur angegebenen Anwendungsdomäne ab.
ICorProfilerInfo::GetAssemblyInfo-Methode	Ruft Informationen zur angegebenen Assembly ab.
ICorProfilerInfo::GetClassFromObject-Methode	Ruft die ClassID eines Objekts mit angegebener ObjectID ab.
ICorProfilerInfo::GetClassFromToken-Methode	Ruft bei angegebenem Metadatentoken die ID der Klasse ab. Diese Methode ist in .NET Framework, Version 2.0, veraltet. Stattdessen wird die ICorProfilerInfo2::GetClassFromTokenAndTypeArgs-Methode verwendet.
ICorProfilerInfo::GetClassIDInfo-Methode	Ruft das übergeordnete Modul und das Metadatentoken für die angegebene Klasse ab.
ICorProfilerInfo::GetCodeInfo-Methode	Ruft den Wertebereich des systemeigenen Codes ab, der der angegebenen Funktions-ID zugeordnet ist. Diese Methode ist veraltet. Verwenden Sie stattdessen die ICorProfilerInfo2::GetCodeInfo2-Methode.
ICorProfilerInfo::GetCurrentThreadID-Methode	Ruft die ID des aktuellen Threads ab, wenn es ein verwalteter Thread ist.
ICorProfilerInfo::GetEventMask-Methode	Ruft die aktuellen Ereigniskategorien ab, für die der Profiler Ereignisbenachrichtigungen von der CLR empfangen möchte.
ICorProfilerInfo::GetFunctionFromIP-Methode	Ordnet einer FunctionID einen Anweisungszeiger im verwalteten Code zu.
ICorProfilerInfo::GetFunctionFromToken-Methode	Ruft die ID einer Funktion ab. Diese Methode ist in .NET Framework, Version 2.0, veraltet. Verwenden Sie stattdessen die ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs-Methode.
ICorProfilerInfo::GetFunctionInfo-Methode	Ruft die übergeordnete Klasse und das Metadatentoken für die angegebene Funktion ab.
ICorProfilerInfo::GetHandleFromThread-Methode	Ordnet die ID eines Threads einem Win32-Threadhandle zu.
ICorProfilerInfo::GetILFunctionBody-Methode	Ruft einen Zeiger auf den Methodentext im MSIL-Code (Microsoft Intermediate Language) ab, beginnend mit dem Header.
ICorProfilerInfo::GetILFunctionBodyAllocator-Methode	Ruft eine Schnittstelle auf, die eine Methode zum Belegen des Arbeitsspeichers bereitstellt, der für die Auslagerung des Texts einer Methode in MSIL-Code verwendet wird.
ICorProfilerInfo::GetILToNativeMapping-Methode	Ruft eine Zuordnung von MSIL-Offsets zu systemeigenen Offsets für den in der angegebenen Funktion enthaltenen Code ab.
ICorProfilerInfo::GetInprocInspectionInterface-Methode	Ruft ein Objekt ab, das nach einer ICorDebugProcess-Schnittstelle abgefragt werden kann. Diese Methode ist in .NET Framework, Version 2.0, veraltet.
ICorProfilerInfo::GetInprocInspectionIThisThread-Methode	Ruft ein Objekt ab, von dem die ICorDebugThread-Schnittstelle abgefragt werden kann. Diese Methode ist in .NET Framework, Version 2.0, veraltet.
ICorProfilerInfo::GetModuleInfo-Methode	Gibt bei vorhandener Modul-ID den Dateinamen des Moduls und die ID der übergeordneten Assembly des Moduls zurück.
ICorProfilerInfo::GetModuleMetaData-Methode	Ruft eine Schnittstelleninstanz für Metadaten ab, die dem angegebenen Modul entspricht.
ICorProfilerInfo::GetObjectSize-Methode	Ruft die Größe eines angegebenen Objekts ab.
ICorProfilerInfo::GetThreadContext-Methode	Ruft die Kontextidentität ab, die momentan dem angegebenen Thread zugeordnet ist.
ICorProfilerInfo::GetThreadInfo-Methode	Ruft die aktuelle Win32-Threadidentität für den angegebenen Thread ab.
ICorProfilerInfo::GetTokenAndMetadataFromFunction-Methode	Ruft das Metadatentoken und eine Instanz der Metadatenschnittstelle ab, die mit dem Token für die angegebene Funktion verwendet werden kann.
ICorProfilerInfo::IsArrayClass-Methode	Ermittelt, ob es sich bei der angegebenen Klasse um eine Arrayklasse handelt.
ICorProfilerInfo::SetEnterLeaveFunctionHooks-Methode	Gibt vom Profiler implementierte Funktionen an, die für die Hooks "enter", "leave" und "tailcall" verwalteter Funktionen aufgerufen werden.
ICorProfilerInfo::SetEventMask-Methode	Legt einen Wert fest, der die Typen der Ereignisse angibt, für die der Profiler Benachrichtigungen von der CLR empfangen möchte.
ICorProfilerInfo::SetFunctionIDMapper-Methode	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.
ICorProfilerInfo::SetFunctionReJIT-Methode	Nicht implementiert. Keine Verwendung.
ICorProfilerInfo::SetILFunctionBody-Methode	Ersetzt den Text der angegebenen Funktion im angegebenen Modul.
ICorProfilerInfo::SetILInstrumentedCodeMap-Methode	Gibt an, wie die Offsets des ursprünglichen MSIL-Codes einer angegebenen Funktion den neuen Offsets des vom Profiler geänderten MSIL-Codes der Funktion zugeordnet werden.

Hinweise

Ein Profiler ruft eine Methode in der ICorProfilerInfo-Schnittstelle zur Kommunikation mit der CLR ab, um die Ereignisüberwachung zu steuern und Informationen anzufordern.

Die Methoden der ICorProfilerInfo-Schnittstelle werden von der CLR über ein Freethreadmodell implementiert. Jede Methode gibt ein HRESULT zurück, um Erfolg oder Fehler anzugeben. Eine Liste möglicher Rückgabecodes finden Sie in CorError.h.

Die CLR übergibt während der Initialisierung an alle Codeprofile eine -Schnittstelle. Sie verwendet dabei die Implementierung vonICorProfilerCallback::InitializeICorProfilerInfo des Profilers. Ein Codeprofiler kann dann Methoden in der ICorProfilerInfo-Schnittstelle aufrufen, um Informationen zu verwaltetem Code abzurufen, dessen Ausführung von der CLR gesteuert wird.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

ICorProfilerInfo2-Schnittstelle

Weitere Ressourcen

Profilerstellungsschnittstellen