COR_PRF_MONITOR-EnumerationCOR_PRF_MONITOR Enumeration

Enthält Werte, die zum Angeben von Verhalten, Funktionen oder Ereignissen verwendet werden, die der Profiler abonnieren muss.Contains values that are used to specify behavior, capabilities, or events to which the profiler wishes to subscribe.

SyntaxSyntax

typedef enum {  
    COR_PRF_MONITOR_NONE                = 0x00000000,  
    COR_PRF_MONITOR_FUNCTION_UNLOADS    = 0x00000001,  
    COR_PRF_MONITOR_CLASS_LOADS         = 0x00000002,  
    COR_PRF_MONITOR_MODULE_LOADS        = 0x00000004,  
    COR_PRF_MONITOR_ASSEMBLY_LOADS      = 0x00000008,  
    COR_PRF_MONITOR_APPDOMAIN_LOADS     = 0x00000010,  
    COR_PRF_MONITOR_JIT_COMPILATION     = 0x00000020,  
    COR_PRF_MONITOR_EXCEPTIONS          = 0x00000040,  
    COR_PRF_MONITOR_GC                  = 0x00000080,  
    COR_PRF_MONITOR_OBJECT_ALLOCATED    = 0x00000100,  
    COR_PRF_MONITOR_THREADS             = 0x00000200,  
    COR_PRF_MONITOR_REMOTING            = 0x00000400,  
    COR_PRF_MONITOR_CODE_TRANSITIONS    = 0x00000800,  
    COR_PRF_MONITOR_ENTERLEAVE          = 0x00001000,  
    COR_PRF_MONITOR_CCW                 = 0x00002000,  
    COR_PRF_MONITOR_REMOTING_COOKIE     = 0x00004000 |
                                          COR_PRF_MONITOR_REMOTING,  
    COR_PRF_MONITOR_REMOTING_ASYNC      = 0x00008000 |
                                          COR_PRF_MONITOR_REMOTING,  
    COR_PRF_MONITOR_SUSPENDS            = 0x00010000,  
    COR_PRF_MONITOR_CACHE_SEARCHES      = 0x00020000,  
    COR_PRF_ENABLE_REJIT                = 0x00040000,  
    COR_PRF_ENABLE_INPROC_DEBUGGING     = 0x00080000,  
    COR_PRF_ENABLE_JIT_MAPS             = 0x00100000,  
    COR_PRF_DISABLE_INLINING            = 0x00200000,  
    COR_PRF_DISABLE_OPTIMIZATIONS       = 0x00400000,  
    COR_PRF_ENABLE_OBJECT_ALLOCATED     = 0x00800000,  
    COR_PRF_MONITOR_CLR_EXCEPTIONS      = 0x01000000,  
    COR_PRF_MONITOR_ALL                 = 0x0107FFFF,  
    COR_PRF_ENABLE_FUNCTION_ARGS        = 0X02000000,  
    COR_PRF_ENABLE_FUNCTION_RETVAL      = 0X04000000,  
    COR_PRF_ENABLE_FRAME_INFO           = 0X08000000,  
    COR_PRF_ENABLE_STACK_SNAPSHOT       = 0X10000000,  
    COR_PRF_USE_PROFILE_IMAGES          = 0x20000000,  
    COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST  
                                        = 0x40000000,  
    COR_PRF_DISABLE_ALL_NGEN_IMAGES     = 0x80000000,  
    COR_PRF_ALL                         = 0x8FFFFFFF,  
    COR_PRF_REQUIRE_PROFILE_IMAGE       = COR_PRF_USE_PROFILE_IMAGES |
                                          COR_PRF_MONITOR_CODE_TRANSITIONS |
                                          COR_PRF_MONITOR_ENTERLEAVE,  
    COR_PRF_ALLOWABLE_AFTER_ATTACH      = COR_PRF_MONITOR_THREADS |  
                                          COR_PRF_MONITOR_MODULE_LOADS |  
                                          COR_PRF_MONITOR_ASSEMBLY_LOADS |  
                                          COR_PRF_MONITOR_APPDOMAIN_LOADS |  
                                          COR_PRF_ENABLE_STACK_SNAPSHOT |  
                                          COR_PRF_MONITOR_GC |  
                                          COR_PRF_MONITOR_SUSPENDS |  
                                          COR_PRF_MONITOR_CLASS_LOADS |  
                                          COR_PRF_MONITOR_JIT_COMPILATION,  
    COR_PRF_MONITOR_IMMUTABLE           = COR_PRF_MONITOR_CODE_TRANSITIONS |  
                                          COR_PRF_MONITOR_REMOTING |  
                                          COR_PRF_MONITOR_REMOTING_COOKIE |  
                                          COR_PRF_MONITOR_REMOTING_ASYNC |  
                                          COR_PRF_ENABLE_REJIT |  
                                          COR_PRF_ENABLE_INPROC_DEBUGGING |  
                                          COR_PRF_ENABLE_JIT_MAPS |  
                                          COR_PRF_DISABLE_OPTIMIZATIONS |  
                                          COR_PRF_DISABLE_INLINING |  
                                          COR_PRF_ENABLE_OBJECT_ALLOCATED |  
                                          COR_PRF_ENABLE_FUNCTION_ARGS |  
                                          COR_PRF_ENABLE_FUNCTION_RETVAL |  
                                          COR_PRF_ENABLE_FRAME_INFO |  
                                          COR_PRF_USE_PROFILE_IMAGES |  
                     COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST |  
                                          COR_PRF_DISABLE_ALL_NGEN_IMAGES  
} COR_PRF_MONITOR;  

MemberMembers

In den folgenden Abschnitten COR_PRF_MONITOR werden Enumerationsmember nach Kategorie aufgelistet.The following sections list COR_PRF_MONITOR enumeration members by category. Die Kategorien lauten:The categories are:

Keine Flags festgelegt.No flags set

MemberMember BeschreibungDescription
COR_PRF_MONITOR_NONE Es sind keine Flags festgelegt.No flags are set.

Rückruf-FlagsCallback flags

MemberMember BeschreibungDescription
COR_PRF_MONITOR_ALL Aktiviert alle Rückrufereignisse.Enables all callback events.
COR_PRF_MONITOR_APPDOMAIN_LOADS Steuert die AppDomainCreation* AppDomainShutdown* Rückrufe und in der ICorProfilerCallback -Schnittstelle.Controls the AppDomainCreation* and AppDomainShutdown* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_ASSEMBLY_LOADS Steuert die AssemblyLoad* AssemblyUnload* Rückrufe und in der ICorProfilerCallback -Schnittstelle.Controls the AssemblyLoad* and AssemblyUnload* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_CACHE_SEARCHES Steuert die JITCachedFunctionSearch* Rückrufe in der ICorProfilerCallback -Schnittstelle.Controls the JITCachedFunctionSearch* callbacks in the ICorProfilerCallback interface.

Das Verhalten dieses Flags ändert sich in Version 2.0 von .NET Framework.The behavior of this flag is changed in the .NET Framework version 2.0.
COR_PRF_MONITOR_CCW Steuert die COMClassicVTable* Rückrufe in der ICorProfilerCallback -Schnittstelle.Controls the COMClassicVTable* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_CLASS_LOADS Steuert die ClassLoad* ClassUnload* Rückrufe und in der ICorProfilerCallback -Schnittstelle.Controls the ClassLoad* and ClassUnload* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_CLR_EXCEPTIONS Steuert die ExceptionCLRCatcher* Rückrufe in der ICorProfilerCallback -Schnittstelle.Controls the ExceptionCLRCatcher* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_CODE_TRANSITIONS Steuert die Rückrufe UnmanagedToManagedTransition und ManagedToUnmanagedTransition in der ICorProfilerCallback -Schnittstelle.Controls the UnmanagedToManagedTransition and ManagedToUnmanagedTransition callbacks in the ICorProfilerCallback interface
COR_PRF_MONITOR_ENTERLEAVE Steuert die FunctionEnter* FunctionLeave* FunctionTailCall* Profilerstellung für globale statische Funktionen, und.Controls the FunctionEnter*, FunctionLeave*, and FunctionTailCall*profiling global static functions.
COR_PRF_MONITOR_EXCEPTIONS Steuert den exceptiondent -Rückruf und ExceptionSearch* die ExceptionOSHandler* ExceptionUnwind* Rückrufe,, und ExceptionCatcher* in der ICorProfilerCallback -Schnittstelle.Controls the ExceptionThrown callback and the ExceptionSearch*, ExceptionOSHandler*, ExceptionUnwind*, and ExceptionCatcher* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_FUNCTION_UNLOADS Steuert den FunctionUnloadStarted -Rückruf in der ICorProfilerCallback -Schnittstelle.Controls the FunctionUnloadStarted callback in the ICorProfilerCallback interface.
COR_PRF_MONITOR_GC Steuert die Rückrufe GarbageCollectionStarted, GarbageCollectionStarted, muvedreferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, objectsallogatedbyclass, RootReferences, RootReferences2, Lenker created, Lenkerund FinalizeableObjectQueued in den ICorProfilerCallback* Schnittstellen.Controls the GarbageCollectionStarted, GarbageCollectionFinished, MovedReferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, ObjectsAllocatedByClass, RootReferences, RootReferences2, HandleCreated, HandleDestroyed, and FinalizeableObjectQueued callbacks in the ICorProfilerCallback* interfaces. Wenn COR_PRF_MONITOR_GC zugeordnet ist, wird das gleichzeitige Garbage Collection ausgeschaltet.When COR_PRF_MONITOR_GC is allocated, concurrent garbage collection is turned off.
COR_PRF_MONITOR_JIT_COMPILATION Steuert die JITCompilation* Rückrufe, JITFunctionPitchedund JITInlining in der ICorProfilerCallback -Schnittstelle.Controls the JITCompilation*, JITFunctionPitched, and JITInlining callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_MODULE_LOADS Steuert die Rückrufe ModuleLoad* , ModuleUnload* und moduleattachedonassembly in der ICorProfilerCallback -Schnittstelle.Controls the ModuleLoad*, ModuleUnload*, and ModuleAttachedToAssembly callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_OBJECT_ALLOCATED Steuert den ObjectAllocated -Rückruf in der ICorProfilerCallback -Schnittstelle.Controls the ObjectAllocated callback in the ICorProfilerCallback interface.
COR_PRF_MONITOR_REMOTING Steuert die Remoting* Rückrufe in der ICorProfilerCallback -Schnittstelle.Controls the Remoting* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_REMOTING_ASYNC Steuert, ob die Remoting*-Rückrufe asynchrone Ereignisse überwachen.Controls whether the Remoting* callbacks will monitor asynchronous events.
COR_PRF_MONITOR_REMOTING_COOKIE Steuert, ob ein Cookie an Remoting*-Rückrufe übergeben wird.Controls whether a cookie is passed to the Remoting* callbacks.
COR_PRF_MONITOR_SUSPENDS Steuert die Rückrufe RuntimeSuspend* , RuntimeResume* , runtimethleseangehalten und runtimethrerunning in der ICorProfilerCallback -Schnittstelle.Controls the RuntimeSuspend*, RuntimeResume*, RuntimeThreadSuspended, and RuntimeThreadResumed callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_THREADS Steuert die Rückrufe ThreadCreated, threadzerstört, threadassigneddeosthreadund ThreadNameChanged in den ICorProfilerCallback -und ICorProfilerCallback2 -Schnittstellen.Controls the ThreadCreated, ThreadDestroyed, ThreadAssignedToOSThread, and ThreadNameChanged callbacks in the ICorProfilerCallback and ICorProfilerCallback2 interfaces.

Flags zur Aktivierung von FunktionenFeature-enabling flags

MemberMember BeschreibungDescription
COR_PRF_ENABLE_FRAME_INFO Ermöglicht das Abrufen eines exakten ClassID für eine generische Funktion durch Aufrufen der GetFunctionInfo2 -Methode mit einem Wert, der COR_PRF_FRAME_INFO vom FunctionEnter2 -Rückruf zurückgegeben wird.Enables the retrieval of an exact ClassID for a generic function by calling the GetFunctionInfo2 method with a COR_PRF_FRAME_INFO value returned by the FunctionEnter2 callback.
COR_PRF_ENABLE_FUNCTION_ARGS Aktiviert die Argument Ablauf Verfolgung mit dem FunctionEnter2 -Rückruf oder dem FunctionEnter3WithInfo -Rückruf und der GetFunctionEnter3Info -Methode.Enables argument tracing using the FunctionEnter2 callback or the FunctionEnter3WithInfo callback and the GetFunctionEnter3Info method.
COR_PRF_ENABLE_FUNCTION_RETVAL Ermöglicht die Ablauf Verfolgung von Rückgabe Werten mit dem FunctionLeave2 -Rückruf oder dem FunctionLeave3WithInfo -Rückruf und der GetFunctionLeave3Info -Methode.Enables tracing of return values by using the FunctionLeave2 callback or the FunctionLeave3WithInfo callback and GetFunctionLeave3Info method.
COR_PRF_ENABLE_INPROC_DEBUGGING Veraltet.Deprecated.

Prozessinternes Debuggen wird nicht unterstützt.In process debugging is not supported. Dieses Flag hat keine Wirkung.This flag has no effect.
COR_PRF_ENABLE_JIT_MAPS Veraltet.Deprecated.

Ermöglicht dem Profiler das Abrufen von Il-to-Native-Zuordnungen mithilfe von GetILToNativeMapping.Allows the profiler to obtain IL-to-native maps by using GetILToNativeMapping. In .NET Framework, Version 2.0 werden Zuordnungen zwischen IL-Code und systemeigenem Code von der CLR immer nachverfolgt, daher gilt dieses Flag immer als gesetzt.Starting with the .NET Framework 2.0, the runtime always tracks IL-to-native maps; therefore, this flag is always considered to be set.
COR_PRF_ENABLE_OBJECT_ALLOCATED Teilt der CLR mit, dass der Profiler u. U. über Objektzuordnungen benachrichtigt werden soll.Informs the runtime that the profiler may want object allocation notifications. Dies muss während der Initialisierung festgelegt werden.This flag must be set during initialization. Dies ermöglicht es dem Profiler, das- COR_PRF_MONITOR_OBJECT_ALLOCATED Flag zu verwenden, um objectallokalisierte Rückrufe zu empfangen.It allows the profiler to subsequently use the COR_PRF_MONITOR_OBJECT_ALLOCATED flag to receive ObjectAllocated callbacks.
COR_PRF_ENABLE_REJIT Aktiviert Aufrufe der Methoden requestrejit und requestrevert .Enables calls to the RequestReJIT and RequestRevert methods. Der Profiler muss dieses Flag beim Start festlegen.The profiler must set this flag on startup. Wenn der Profiler dieses Flag angibt, muss er auch COR_PRF_DISABLE_ALL_NGEN_IMAGES angeben.If the profiler specifies this flag, it must also specify COR_PRF_DISABLE_ALL_NGEN_IMAGES.
COR_PRF_ENABLE_STACK_SNAPSHOT Aktiviert Aufrufe der DoStackSnapshot -Methode.Enables calls to the DoStackSnapshot method.

KonfigurationsflagsConfiguration flags

MemberMember BeschreibungDescription
COR_PRF_DISABLE_ALL_NGEN_IMAGES Bewirkt, dass die systemeigene Abbildsuche nach Abbildern (einschließlich durch Profiler verbesserte) sucht.Prevents all native images (including profiler-enhanced images) from loading. Wenn dieses Flag und das COR_PRF_USE_PROFILE_IMAGES-Flag beide angegeben sind, wird COR_PRF_DISABLE_ALL_NGEN_IMAGES verwendet.If this flag and the COR_PRF_USE_PROFILE_IMAGES flag are both specified, COR_PRF_DISABLE_ALL_NGEN_IMAGES is used.
COR_PRF_DISABLE_INLINING Deaktiviert das gesamte Inlining.Disables all inlining.
COR_PRF_DISABLE_OPTIMIZATIONS Deaktiviert alle Codeoptimierungen.Disables all code optimizations.
COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST Deaktiviert Sicherheitstransparenzprüfungen, die normalerweise während Just-In-Time (JIT)-Kompilierungen und dem Laden von Klassen für vollständig vertrauenswürdige Assemblys durchgeführt werden.Disables security transparency checks that are normally done during just-in-time (JIT) compilation and class loading for full-trust assemblies. Dies kann die Ausführung einiger Instrumentierungsvorgänge erleichtern.This can make some instrumentation easier to perform.
COR_PRF_USE_PROFILE_IMAGES Bewirkt, dass die systemeigene Abbildsuche nach durch Profiler verbesserten Abbildern sucht.Causes the native image search to look for profiler-enhanced images. Wenn für eine Assembly kein durch Profiler verbessertes Bild gefunden wird, greift die Common Language Runtime für die betreffende Assembly wieder auf JIT zurück.If no profiler-enhanced image is found for a given assembly, the common language runtime falls back to JIT for that assembly. Wenn dieses Flag und das COR_PRF_DISABLE_ALL_NGEN_IMAGES-Flag beide angegeben sind, wird COR_PRF_DISABLE_ALL_NGEN_IMAGES verwendet.If this flag and the COR_PRF_DISABLE_ALL_NGEN_IMAGES flag are both specified, COR_PRF_DISABLE_ALL_NGEN_IMAGES is used.

Kombinierte FlagsComposite flags

MemberMember BeschreibungDescription
COR_PRF_ALL Stellt alle COR_PRF_MONITOR-Flagwerte dar.Represents all COR_PRF_MONITOR flag values.
COR_PRF_ALLOWABLE_AFTER_ATTACH Stellt alle COR_PRF_MONITOR-Flags dar, die festgelegt werden können, wenn der Profiler mit einer ausgeführten App verknüpft wurde.Represents all COR_PRF_MONITOR flags that can be set after the profiler is attached to a running app. Der Syntaxabschnitt gibt die einzelnen Flags an, die in dieser Bitmask vorhanden sind.The syntax section indicates the individual flags that are present in this bitmask.
COR_PRF_MONITOR_ALL Aktiviert alle Rückrufereignisse.Enables all callback events.
COR_PRF_MONITOR_IMMUTABLE Stellt alle COR_PRF_MONITOR-Flags dar, die nur während der Initialisierung festgelegt werden können.Represents all COR_PRF_MONITOR flags that can be set only during initialization. Wenn Sie versuchen, eines dieser Flags nach der Initialisierung zu ändern, führt dies zu einem HRESULT-Wert, der auf einen Fehler hinweist.Trying to change any of these flags after initialization returns an HRESULT value that indicates failure.
COR_PRF_REQUIRE_PROFILE_IMAGE Stellt alle COR_PRF_MONITOR-Flags dar, die durch Profiler verbesserte Bilder erfordern.Represents all COR_PRF_MONITOR flags that require profile-enhanced images.

BemerkungenRemarks

Ein COR_PRF_MONITOR -Wert wird mit den Methoden ICorProfilerInfo:: GetEventMask und ICorProfilerInfo:: lteventmask verwendet, um die Ereignis Benachrichtigungen zu definieren, die die Common Language Runtime an den Profiler sendet.A COR_PRF_MONITOR value is used with the ICorProfilerInfo::GetEventMask and ICorProfilerInfo::SetEventMask methods to define the event notifications that the common language runtime makes to the profiler.

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