ICorProfilerCallback-SchnittstelleICorProfilerCallback Interface

Stellt Methoden bereit, die vom Common Language Runtime (CLR) verwendet werden, um einen Codeprofiler zu benachrichtigen, wenn die Ereignisse, die der Profiler abonniert hat, auftreten.Provides methods that are used by the common language runtime (CLR) to notify a code profiler when the events to which the profiler has subscribed occur.

MethodenMethods

MethodeMethod BESCHREIBUNGDescription
AppDomainCreationFinished-MethodeAppDomainCreationFinished Method Benachrichtigt den Profiler, dass eine Anwendungsdomäne erstellt wurde.Notifies the profiler that an application domain has been created.
AppDomainCreationStarted-MethodeAppDomainCreationStarted Method Benachrichtigt den Profiler, dass eine Anwendungsdomäne erstellt wird.Notifies the profiler that an application domain is being created.
AppDomainShutdownFinished-MethodeAppDomainShutdownFinished Method Benachrichtigt den Profiler, dass eine Anwendungsdomäne von einem Prozess entladen wurde.Notifies the profiler that an application domain has been unloaded from a process.
AppDomainShutdownStarted-MethodeAppDomainShutdownStarted Method Benachrichtigt den Profiler, dass eine Anwendungsdomäne von einem Prozess entladen wird.Notifies the profiler that an application domain is being unloaded from a process.
AssemblyLoadFinished-MethodeAssemblyLoadFinished Method Benachrichtigt den Profiler, dass eine Assembly den Ladevorgang abgeschlossen hat.Notifies the profiler that an assembly has finished loading.
AssemblyLoadStarted-MethodeAssemblyLoadStarted Method Benachrichtigt den Profiler, dass eine Assembly geladen wird.Notifies the profiler that an assembly is being loaded.
AssemblyUnloadFinished-MethodeAssemblyUnloadFinished Method Benachrichtigt den Profiler, dass eine Assembly entladen wurde.Notifies the profiler that an assembly has been unloaded.
AssemblyUnloadStarted-MethodeAssemblyUnloadStarted Method Benachrichtigt den Profiler, dass eine Assembly entladen wird.Notifies the profiler that an assembly is being unloaded.
ClassLoadFinished-MethodeClassLoadFinished Method Benachrichtigt den Profiler, dass eine Klasse den Ladevorgang abgeschlossen hat.Notifies the profiler that a class has finished loading.
ClassLoadStarted-MethodeClassLoadStarted Method Benachrichtigt den Profiler, dass eine Klasse geladen wird.Notifies the profiler that a class is being loaded.
ClassUnloadFinished-MethodeClassUnloadFinished Method Benachrichtigt den Profiler, dass eine Klasse das entladen abgeschlossen hat.Notifies the profiler that a class has finished unloading.
ClassUnloadStarted-MethodeClassUnloadStarted Method Benachrichtigt den Profiler, dass eine Klasse entladen wird.Notifies the profiler that a class is being unloaded.
COMClassicVTableCreated-MethodeCOMClassicVTableCreated Method Benachrichtigt den Profiler, dass ein Runtime Callable Wrapper (RCW) für die angegebene IID und die angegebene Klasse erstellt wurde.Notifies the profiler that a runtime callable wrapper (RCW) for the specified IID and class has been created.
COMClassicVTableDestroyed-MethodeCOMClassicVTableDestroyed Method Benachrichtigt den Profiler, dass ein RCW zerstört wird.Notifies the profiler that an RCW is being destroyed.
ExceptionCatcherEnter-MethodeExceptionCatcherEnter Method Benachrichtigt den Profiler, dass das Steuerelement an den entsprechenden-Block übermittelt wird catch .Notifies the profiler that control is being passed to the appropriate catch block.
ExceptionCatcherLeave-MethodeExceptionCatcherLeave Method Benachrichtigt den Profiler, dass das Steuerelement aus dem entsprechenden-Block herausgegeben wird catch .Notifies the profiler that control is being passed out of the appropriate catch block.
ExceptionCLRCatcherExecute-MethodeExceptionCLRCatcherExecute Method Veraltet in der .NET Framework Version 2,0.Obsolete in the .NET Framework version 2.0.
ExceptionCLRCatcherFound-MethodeExceptionCLRCatcherFound Method Veraltet in .NET Framework 2,0.Obsolete in the .NET Framework 2.0.
ExceptionOSHandlerEnter-MethodeExceptionOSHandlerEnter Method Nicht implementiert.Not implemented. Ein Profiler, der Informationen zu nicht verwalteten Ausnahmen benötigt, muss diese Informationen auf andere Weise abrufen.A profiler that needs unmanaged exception information must obtain this information through other means.
ExceptionOSHandlerLeave-MethodeExceptionOSHandlerLeave Method Nicht implementiert.Not implemented. Ein Profiler, der Informationen zu nicht verwalteten Ausnahmen benötigt, muss diese Informationen auf andere Weise abrufen.A profiler that needs unmanaged exception information must obtain this information through other means.
ExceptionSearchCatcherFound-MethodeExceptionSearchCatcherFound Method Benachrichtigt den Profiler, dass die Such Phase der Ausnahmebehandlung einen Handler für die ausgelöste Ausnahme gefunden hat.Notifies the profiler that the search phase of exception handling has located a handler for the exception that was thrown.
ExceptionSearchFilterEnter-MethodeExceptionSearchFilterEnter Method Benachrichtigt den Profiler, dass ein Benutzer Filter ausgeführt wird.Notifies the profiler that a user filter is being executed.
ExceptionSearchFilterLeave-MethodeExceptionSearchFilterLeave Method Benachrichtigt den Profiler, dass die Ausführung eines Benutzer Filters soeben abgeschlossen ist.Notifies the profiler that a user filter has just finished executing.
ExceptionSearchFunctionEnter-MethodeExceptionSearchFunctionEnter Method Benachrichtigt den Profiler, dass die Such Phase der Ausnahmebehandlung in eine Funktion eingetreten ist.Notifies the profiler that the search phase of exception handling has entered a function.
ExceptionSearchFunctionLeave-MethodeExceptionSearchFunctionLeave Method Benachrichtigt den Profiler, dass die Such Phase der Ausnahmebehandlung das Durchsuchen einer Funktion abgeschlossen hat.Notifies the profiler that the search phase of exception handling has finished searching a function.
ExceptionThrown-MethodeExceptionThrown Method Benachrichtigt den Profiler, dass eine Ausnahme ausgelöst wurde.Notifies the profiler that an exception has been thrown.
ExceptionUnwindFinallyEnter-MethodeExceptionUnwindFinallyEnter Method Benachrichtigt den Profiler, dass die Entladephase der Ausnahmebehandlung in eine finally in der angegebenen Funktion enthaltene Klausel eintritt.Notifies the profiler that the unwind phase of exception handling is entering a finally clause contained in the specified function.
ExceptionUnwindFinallyLeave-MethodeExceptionUnwindFinallyLeave Method Benachrichtigt den Profiler, dass die Entladephase der Ausnahmebehandlung eine-Klausel hinterlassen hat finally .Notifies the profiler that the unwind phase of exception handling has left a finally clause.
ExceptionUnwindFunctionEnter-MethodeExceptionUnwindFunctionEnter Method Benachrichtigt den Profiler, dass die Entladephase der Ausnahmebehandlung in eine Funktion eingetreten ist.Notifies the profiler that the unwind phase of exception handling has entered a function.
ExceptionUnwindFunctionLeave-MethodeExceptionUnwindFunctionLeave Method Benachrichtigt den Profiler, dass die Entladephase der Ausnahmebehandlung das Entladen einer Funktion abgeschlossen hat.Notifies the profiler that the unwind phase of exception handling has finished unwinding a function.
FunctionUnloadStarted-MethodeFunctionUnloadStarted Method Benachrichtigt den Profiler, dass die Laufzeit begonnen hat, eine Funktion zu entladen.Notifies the profiler that the runtime has started to unload a function.
Initialize-MethodeInitialize Method Wird aufgerufen, um den Profiler zu initialisieren, wenn eine neue CLR-Anwendung gestartet wird.Called to initialize the profiler whenever a new CLR application is started.
JITCachedFunctionSearchFinished-MethodeJITCachedFunctionSearchFinished Method Benachrichtigt den Profiler, dass eine Suche für eine Funktion abgeschlossen wurde, die zuvor mithilfe von "ngen. exe" kompiliert wurde.Notifies the profiler that a search has finished for a function that was compiled previously using NGen.exe.
JITCachedFunctionSearchStarted-MethodeJITCachedFunctionSearchStarted Method Benachrichtigt den Profiler, dass eine Suche für eine Funktion gestartet wurde, die zuvor mithilfe von "ngen. exe" kompiliert wurde.Notifies the profiler that a search has started for a function that was compiled previously using NGen.exe.
JITCompilationFinished-MethodeJITCompilationFinished Method Benachrichtigt den Profiler, dass der JIT-Compiler die Kompilierung einer Funktion abgeschlossen hat.Notifies the profiler that the JIT compiler has finished compiling a function.
JITCompilationStarted-MethodeJITCompilationStarted Method Benachrichtigt den Profiler, dass der JIT-Compiler (Just-in-Time) die Kompilierung einer Funktion gestartet hat.Notifies the profiler that the just-in-time (JIT) compiler has started to compile a function.
JITFunctionPitched-MethodeJITFunctionPitched Method Benachrichtigt den Profiler, dass eine JIT-kompilierte Funktion aus dem Arbeitsspeicher entfernt wurde.Notifies the profiler that a function that has been JIT-compiled has been removed from memory.
JITInlining-MethodeJITInlining Method Benachrichtigt den Profiler, dass der JIT-Compiler im Begriff ist, eine Funktion in einer anderen Funktion einzufügen.Notifies the profiler that the JIT compiler is about to insert a function in line with another function.
ManagedToUnmanagedTransition-MethodeManagedToUnmanagedTransition Method Benachrichtigt den Profiler, dass ein Übergang von verwaltetem Code zu nicht verwaltetem Code erfolgt ist.Notifies the profiler that a transition from managed code to unmanaged code has occurred.
ModuleAttachedToAssembly-MethodeModuleAttachedToAssembly Method Benachrichtigt den Profiler, dass ein Modul an die übergeordnete Assembly angefügt wird.Notifies the profiler that a module is being attached to its parent assembly.
ModuleLoadFinished-MethodeModuleLoadFinished Method Benachrichtigt den Profiler, dass ein Modul den Ladevorgang abgeschlossen hat.Notifies the profiler that a module has finished loading.
ModuleLoadStarted-MethodeModuleLoadStarted Method Benachrichtigt den Profiler, dass ein Modul geladen wird.Notifies the profiler that a module is being loaded.
ModuleUnloadFinished-MethodeModuleUnloadFinished Method Benachrichtigt den Profiler, dass ein Modul das entladen abgeschlossen hat.Notifies the profiler that a module has finished unloading.
ModuleUnloadStarted-MethodeModuleUnloadStarted Method Benachrichtigt den Profiler, dass ein Modul entladen wird.Notifies the profiler that a module is being unloaded.
MovedReferences-MethodeMovedReferences Method Benachrichtigt den Profiler über Objekt Verweise, die während Garbage Collection verschoben wurden.Notifies the profiler about object references that were moved during garbage collection.
ObjectAllocated-MethodeObjectAllocated Method Benachrichtigt den Profiler, dass der Arbeitsspeicher im Heap für ein Objekt zugeordnet wurde.Notifies the profiler that memory within the heap has been allocated for an object.
ObjectReferences-MethodeObjectReferences Method Benachrichtigt den Profiler über Objekte im Speicher, auf die vom angegebenen-Objekt verwiesen wird.Notifies the profiler about objects in memory referenced by the specified object.
ObjectsAllocatedByClass-MethodeObjectsAllocatedByClass Method Benachrichtigt den Profiler über die Anzahl von Instanzen der angegebenen Klasse, die seit dem vorherigen Garbage Collection erstellt wurden.Notifies the profiler about the number of instances of each specified class that have been created since the previous garbage collection.
RemotingClientInvocationFinished-MethodeRemotingClientInvocationFinished Method Benachrichtigt den Profiler, dass ein Remotingaufrufe auf dem Client ausgeführt werden muss.Notifies the profiler that a remoting call has run to completion on the client.
RemotingClientInvocationStarted-MethodeRemotingClientInvocationStarted Method Benachrichtigt den Profiler, dass ein remotingbefehl gestartet wurde.Notifies the profiler that a remoting call has started.
RemotingClientReceivingReply-MethodeRemotingClientReceivingReply Method Benachrichtigt den Profiler, dass der serverseitige Teil eines remotingaufrufes abgeschlossen wurde und der Client die Antwort nun empfängt und verarbeitet.Notifies the profiler that the server-side portion of a remoting call has completed and the client is now receiving and about to process the reply.
RemotingClientSendingMessage-MethodeRemotingClientSendingMessage Method Benachrichtigt den Profiler, dass der Client eine Anforderung an den Server sendet.Notifies the profiler that the client is sending a request to the server.
RemotingServerInvocationReturned-MethodeRemotingServerInvocationReturned Method Benachrichtigt den Profiler, dass der Prozess den Aufruf einer Methode als Reaktion auf eine Anforderung für eine Remote Methodenaufruf abgeschlossen hat.Notifies the profiler that the process has finished invoking a method in response to a remote method invocation request.
RemotingServerInvocationStarted-MethodeRemotingServerInvocationStarted Method Benachrichtigt den Profiler, dass der Prozess eine Methode als Reaktion auf eine Aufruf Anforderung für eine Remote Methode aufruft.Notifies the profiler that the process is invoking a method in response to a remote method invocation request.
RemotingServerReceivingMessage-MethodeRemotingServerReceivingMessage Method Benachrichtigt den Profiler, dass der Prozess eine Remote Methodenaufruf-oder Aktivierungs Anforderung empfängt.Notifies the profiler that the process is receiving a remote method invocation or activation request.
RemotingServerSendingReply-MethodeRemotingServerSendingReply Method Benachrichtigt den Profiler, dass der Prozess die Verarbeitung einer Remote Methodenaufruf Anforderung abgeschlossen hat und die Antwort über einen Kanal überträgt.Notifies the profiler that the process has finished processing a remote method invocation request and is about to transmit the reply through a channel.
RootReferences-MethodeRootReferences Method Benachrichtigt den Profiler über Informationen über Stamm Verweise nach Garbage Collection.Notifies the profiler with information about root references after garbage collection.
RuntimeResumeFinished-MethodeRuntimeResumeFinished Method Benachrichtigt den Profiler, dass die Laufzeit alle Laufzeitthreads fortgesetzt hat und an den normalen Vorgang zurückgegeben wurde.Notifies the profiler that the runtime has resumed all runtime threads and has returned to normal operation.
RuntimeResumeStarted-MethodeRuntimeResumeStarted Method Benachrichtigt den Profiler, dass die Laufzeit alle Laufzeitthreads fortsetzt.Notifies the profiler that the runtime is resuming all run-time threads.
RuntimeSuspendAborted-MethodeRuntimeSuspendAborted Method Benachrichtigt den Profiler, dass die Laufzeit die ausgeführte Lauf Zeit Unterbrechung abgebrochen hat.Notifies the profiler that the runtime has aborted the run-time suspension that was occurring.
RuntimeSuspendFinished-MethodeRuntimeSuspendFinished Method Benachrichtigt den Profiler, dass die Laufzeit alle Laufzeitthreads angehalten hat.Notifies the profiler that the runtime has completed suspension of all run-time threads.
RuntimeSuspendStarted-MethodeRuntimeSuspendStarted Method Benachrichtigt den Profiler, dass die Laufzeit alle Laufzeitthreads aussetzen soll.Notifies the profiler that the runtime is about to suspend all run-time threads.
RuntimeThreadResumed-MethodeRuntimeThreadResumed Method Benachrichtigt den Profiler, dass der angegebene Thread nach dem aussetzen fortgesetzt wurde.Notifies the profiler that the specified thread has resumed after being suspended.
RuntimeThreadSuspended-MethodeRuntimeThreadSuspended Method Benachrichtigt den Profiler, dass der angegebene Thread angehalten wurde oder gerade angehalten wird.Notifies the profiler that the specified thread has been, or is about to be, suspended.
Shutdown-MethodeShutdown Method Benachrichtigt den Profiler, dass die Anwendung heruntergefahren wird.Notifies the profiler that the application is shutting down.
ThreadAssignedToOSThread-MethodeThreadAssignedToOSThread Method Benachrichtigt den Profiler, dass ein verwalteter Thread mit einem bestimmten Betriebssystem Thread (OS) implementiert wird.Notifies the profiler that a managed thread is being implemented using a particular operating system (OS) thread.
ThreadCreated-MethodeThreadCreated Method Benachrichtigt den Profiler, dass ein Thread erstellt wurde.Notifies the profiler that a thread has been created.
ThreadDestroyed-MethodeThreadDestroyed Method Benachrichtigt den Profiler, dass ein Thread zerstört wurde.Notifies the profiler that a thread has been destroyed.
UnmanagedToManagedTransition-MethodeUnmanagedToManagedTransition Method Benachrichtigt den Profiler, dass ein Übergang von nicht verwaltetem Code zu verwaltetem Code erfolgt ist.Notifies the profiler that a transition from unmanaged code to managed code has occurred.

BemerkungenRemarks

Die CLR ruft eine Methode in der- ICorProfilerCallback Schnittstelle (oder der ICorProfilerCallback2) auf, um den Profiler zu benachrichtigen, wenn ein Ereignis auftritt, das der Profiler abonniert hat.The CLR calls a method in the ICorProfilerCallback (or ICorProfilerCallback2) interface to notify the profiler when an event, to which the profiler has subscribed, occurs. Dies ist die primäre Rückruf Schnittstelle, über die die CLR mit dem Codeprofiler kommuniziert.This is the primary callback interface through which the CLR communicates with the code profiler.

Ein Codeprofiler muss die Methoden der- ICorProfilerCallback Schnittstelle implementieren.A code profiler must implement the methods of the ICorProfilerCallback interface. Für den .NET Framework, Version 2,0 oder höher, muss der Profiler auch die- ICorProfilerCallback2 Methoden implementieren.For the .NET Framework version 2.0 or later, the profiler must also implement the ICorProfilerCallback2 methods. Jede Methoden Implementierung muss ein HRESULT zurückgeben, das bei Erfolg oder E_FAIL bei einem Fehler den Wert S_OK hat.Each method implementation must return an HRESULT that has a value of S_OK on success or E_FAIL on failure. Derzeit ignoriert die CLR das HRESULT, das von jedem Rückruf zurückgegeben wird, mit Ausnahme von ICorProfilerCallback:: ObjectReferences.Currently, the CLR ignores the HRESULT that is returned by each callback except ICorProfilerCallback::ObjectReferences.

In der Microsoft Windows-Registrierung muss ein Codeprofiler sein Component Object Model (com)-Objekt registrieren, das die ICorProfilerCallback -Schnittstelle und die-Schnittstelle implementiert ICorProfilerCallback2 .In the Microsoft Windows registry, a code profiler must register its Component Object Model (COM) object that implements the ICorProfilerCallback and ICorProfilerCallback2 interfaces. Ein Codeprofiler abonniert die Ereignisse, für die er eine Benachrichtigung erhalten möchte, indem er ICorProfilerInfo:: SetEventMaskanfordert.A code profiler subscribes to the events for which it wants to receive notification by calling ICorProfilerInfo::SetEventMask. Dies erfolgt in der Regel in der Implementierung von ICorProfilerCallback:: Initializedurch den Profiler.This is usually done in the profiler's implementation of ICorProfilerCallback::Initialize. Der Profiler kann dann eine Benachrichtigung von der Laufzeit empfangen, wenn ein Ereignis im Begriff ist oder gerade in einem ausgeführten Lauf Zeit Prozess aufgetreten ist.The profiler is then able to receive notification from the runtime when an event is about to occur or has just occurred in an executing runtime process.

Hinweis

Der Profiler registriert ein einzelnes COM-Objekt.The profiler registers a single COM object. Wenn der Profiler auf die .NET Framework Version 1,0 oder 1,1 abzielt, muss dieses COM-Objekt nur die Methoden von implementieren ICorProfilerCallback .If the profiler is targeting the .NET Framework version 1.0 or 1.1, that COM object needs to implement only the methods of ICorProfilerCallback. Wenn .NET Framework Version 2,0 oder höher als Zielversion verwendet wird, muss das COM-Objekt auch die Methoden von implementieren ICorProfilerCallback2 .If it is targeting .NET Framework version 2.0 or later, the COM object must also implement the methods of ICorProfilerCallback2.

Requirements (Anforderungen)Requirements

Plattformen: Informationen finden Sie unter Systemanforderungen.Platforms: See System Requirements.

Header: CorProf.idl, CorProf.hHeader: CorProf.idl, CorProf.h

Bibliothek: CorGuids.libLibrary: CorGuids.lib

.NET Framework Versionen:Verfügbar seit 1.0Available since 1.0.NET Framework Versions: Verfügbar seit 1.0Available since 1.0

Weitere Informationen:See also