COR_PRF_MONITOR, énumérationCOR_PRF_MONITOR Enumeration

Contient des valeurs utilisées pour spécifier un comportement, des fonctionnalités ou des événements auxquels le profileur veut s'abonner.Contains values that are used to specify behavior, capabilities, or events to which the profiler wishes to subscribe.

SyntaxeSyntax

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;  

MembresMembers

Les sections suivantes répertorient COR_PRF_MONITOR membres de l’énumération par catégorie.The following sections list COR_PRF_MONITOR enumeration members by category. Les catégories sont :The categories are:

Aucun jeu d’indicateursNo flags set

MembreMember DescriptionDescription
COR_PRF_MONITOR_NONE Aucun indicateur n'est défini.No flags are set.

Indicateurs de rappelCallback flags

MembreMember DescriptionDescription
COR_PRF_MONITOR_ALL Active tous les événements de rappel.Enables all callback events.
COR_PRF_MONITOR_APPDOMAIN_LOADS Contrôles le AppDomainCreation* et AppDomainShutdown* rappels dans le ICorProfilerCallback interface.Controls the AppDomainCreation* and AppDomainShutdown* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_ASSEMBLY_LOADS Contrôles le AssemblyLoad* et AssemblyUnload* rappels dans le ICorProfilerCallback interface.Controls the AssemblyLoad* and AssemblyUnload* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_CACHE_SEARCHES Contrôles le JITCachedFunctionSearch* rappels dans le ICorProfilerCallback interface.Controls the JITCachedFunctionSearch* callbacks in the ICorProfilerCallback interface.

Le comportement de cet indicateur est changé dans .NET Framework version 2.0.The behavior of this flag is changed in the .NET Framework version 2.0.
COR_PRF_MONITOR_CCW Contrôles le COMClassicVTable* rappels dans le ICorProfilerCallback interface.Controls the COMClassicVTable* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_CLASS_LOADS Contrôles le ClassLoad* et ClassUnload* rappels dans le ICorProfilerCallback interface.Controls the ClassLoad* and ClassUnload* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_CLR_EXCEPTIONS Contrôles le ExceptionCLRCatcher* rappels dans le ICorProfilerCallback interface.Controls the ExceptionCLRCatcher* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_CODE_TRANSITIONS Contrôles le UnmanagedToManagedTransition et ManagedToUnmanagedTransition rappels dans le ICorProfilerCallback interfaceControls the UnmanagedToManagedTransition and ManagedToUnmanagedTransition callbacks in the ICorProfilerCallback interface
COR_PRF_MONITOR_ENTERLEAVE Contrôles le FunctionEnter*, FunctionLeave*, et FunctionTailCall* fonctions statiques globales du profilage.Controls the FunctionEnter*, FunctionLeave*, and FunctionTailCall*profiling global static functions.
COR_PRF_MONITOR_EXCEPTIONS Contrôles le ExceptionThrown rappel et le ExceptionSearch*, ExceptionOSHandler*, ExceptionUnwind*, et ExceptionCatcher* rappels dans le ICorProfilerCallback interface.Controls the ExceptionThrown callback and the ExceptionSearch*, ExceptionOSHandler*, ExceptionUnwind*, and ExceptionCatcher* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_FUNCTION_UNLOADS Contrôles le FunctionUnloadStarted rappel dans le ICorProfilerCallback interface.Controls the FunctionUnloadStarted callback in the ICorProfilerCallback interface.
COR_PRF_MONITOR_GC Contrôles le GarbageCollectionStarted, GarbageCollectionFinished, MovedReferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, ObjectsAllocatedByClass, RootReferences, RootReferences2, HandleCreated, HandleDestroyed, et FinalizeableObjectQueued rappels dans le ICorProfilerCallback* interfaces.Controls the GarbageCollectionStarted, GarbageCollectionFinished, MovedReferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, ObjectsAllocatedByClass, RootReferences, RootReferences2, HandleCreated, HandleDestroyed, and FinalizeableObjectQueued callbacks in the ICorProfilerCallback* interfaces. Lorsque COR_PRF_MONITOR_GC est alloué, simultané garbage collection est désactivée.When COR_PRF_MONITOR_GC is allocated, concurrent garbage collection is turned off.
COR_PRF_MONITOR_JIT_COMPILATION Contrôles le JITCompilation*, JITFunctionPitched, et JITInlining rappels dans le ICorProfilerCallback interface.Controls the JITCompilation*, JITFunctionPitched, and JITInlining callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_MODULE_LOADS Contrôles le ModuleLoad*, ModuleUnload*, et ModuleAttachedToAssembly rappels dans le ICorProfilerCallback interface.Controls the ModuleLoad*, ModuleUnload*, and ModuleAttachedToAssembly callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_OBJECT_ALLOCATED Contrôles le ObjectAllocated rappel dans le ICorProfilerCallback interface.Controls the ObjectAllocated callback in the ICorProfilerCallback interface.
COR_PRF_MONITOR_REMOTING Contrôles le Remoting* rappels dans le ICorProfilerCallback interface.Controls the Remoting* callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_REMOTING_ASYNC Contrôle si les rappels Remoting* surveillent les événements asynchrones.Controls whether the Remoting* callbacks will monitor asynchronous events.
COR_PRF_MONITOR_REMOTING_COOKIE Contrôle si un cookie est passé aux rappels Remoting*.Controls whether a cookie is passed to the Remoting* callbacks.
COR_PRF_MONITOR_SUSPENDS Contrôles le RuntimeSuspend*, RuntimeResume*, RuntimeThreadSuspended, et RuntimeThreadResumed rappels dans le ICorProfilerCallback interface.Controls the RuntimeSuspend*, RuntimeResume*, RuntimeThreadSuspended, and RuntimeThreadResumed callbacks in the ICorProfilerCallback interface.
COR_PRF_MONITOR_THREADS Contrôles le ThreadCreated, ThreadDestroyed, ThreadAssignedToOSThread, et ThreadNameChanged rappels dans le ICorProfilerCallback et ICorProfilerCallback2 interfaces.Controls the ThreadCreated, ThreadDestroyed, ThreadAssignedToOSThread, and ThreadNameChanged callbacks in the ICorProfilerCallback and ICorProfilerCallback2 interfaces.

Indicateurs d’activation de fonctionnalitéFeature-enabling flags

MembreMember DescriptionDescription
COR_PRF_ENABLE_FRAME_INFO Active la récupération d’une manière exacte ClassID pour une fonction générique en appelant le GetFunctionInfo2 méthode avec un COR_PRF_FRAME_INFO valeur retournée par la FunctionEnter2 rappel.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 Traçage de l’argument permet à l’aide du FunctionEnter2 rappel ou FunctionEnter3WithInfo rappel et le GetFunctionEnter3Info (méthode).Enables argument tracing using the FunctionEnter2 callback or the FunctionEnter3WithInfo callback and the GetFunctionEnter3Info method.
COR_PRF_ENABLE_FUNCTION_RETVAL Active le traçage des valeurs de retour à l’aide de la FunctionLeave2 rappel ou FunctionLeave3WithInfo rappel et GetFunctionLeave3Info (méthode).Enables tracing of return values by using the FunctionLeave2 callback or the FunctionLeave3WithInfo callback and GetFunctionLeave3Info method.
COR_PRF_ENABLE_INPROC_DEBUGGING Action déconseillée.Deprecated.

Le débogage in-process n'est pas pris en charge.In process debugging is not supported. Cet indicateur est sans effet.This flag has no effect.
COR_PRF_ENABLE_JIT_MAPS Action déconseillée.Deprecated.

Permet au profileur d’obtenir des mappages de langage intermédiaire – natif à l’aide de GetILToNativeMapping.Allows the profiler to obtain IL-to-native maps by using GetILToNativeMapping. Depuis .NET Framework 2.0, le runtime fait toujours le suivi des mappes Langage intermédiaire – Natif. Cet indicateur est donc toujours considéré comme étant défini.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 Informe le runtime que le profileur est susceptible de demander l'allocation d'objets.Informs the runtime that the profiler may want object allocation notifications. Cet indicateur doit être défini lors de l'initialisation.This flag must be set during initialization. Il permet au profileur d’utiliser ensuite le COR_PRF_MONITOR_OBJECT_ALLOCATED indicateur recevoir ObjectAllocated rappels.It allows the profiler to subsequently use the COR_PRF_MONITOR_OBJECT_ALLOCATED flag to receive ObjectAllocated callbacks.
COR_PRF_ENABLE_REJIT Active les appels à la RequestReJIT et RequestRevert méthodes.Enables calls to the RequestReJIT and RequestRevert methods. Le profileur doit définir cet indicateur au démarrage.The profiler must set this flag on startup. Si le profileur spécifie cet indicateur, il doit aussi spécifier COR_PRF_DISABLE_ALL_NGEN_IMAGES.If the profiler specifies this flag, it must also specify COR_PRF_DISABLE_ALL_NGEN_IMAGES.
COR_PRF_ENABLE_STACK_SNAPSHOT Active les appels à la DoStackSnapshot (méthode).Enables calls to the DoStackSnapshot method.

Indicateurs de configurationConfiguration flags

MembreMember DescriptionDescription
COR_PRF_DISABLE_ALL_NGEN_IMAGES Empêche le chargement de toutes les images natives (y compris les images optimisées par le profileur).Prevents all native images (including profiler-enhanced images) from loading. Si cet indicateur et l'indicateur COR_PRF_USE_PROFILE_IMAGES sont tous deux spécifiés, COR_PRF_DISABLE_ALL_NGEN_IMAGES est utilisé.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 Désactive toutes les incorporations.Disables all inlining.
COR_PRF_DISABLE_OPTIMIZATIONS Désactive toutes les optimisations du code.Disables all code optimizations.
COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST Désactive les vérifications de transparence de sécurité qui sont normalement effectuées lors de la compilation juste-à-temps et le chargement des classes pour les assemblys de confiance totale.Disables security transparency checks that are normally done during just-in-time (JIT) compilation and class loading for full-trust assemblies. Ceci peut rendre certaines instrumentations plus faciles à effectuer.This can make some instrumentation easier to perform.
COR_PRF_USE_PROFILE_IMAGES Fait que la recherche d'images natives s'effectue dans les images optimisées par le profileur.Causes the native image search to look for profiler-enhanced images. Si aucune image optimisée par le profileur n'est trouvée pour un assembly donné, le CLR (Common Language Runtime) passe au juste-à-temps pour cet assembly.If no profiler-enhanced image is found for a given assembly, the common language runtime falls back to JIT for that assembly. Si cet indicateur et l'indicateur COR_PRF_DISABLE_ALL_NGEN_IMAGES sont tous deux spécifiés, COR_PRF_DISABLE_ALL_NGEN_IMAGES est utilisé.If this flag and the COR_PRF_DISABLE_ALL_NGEN_IMAGES flag are both specified, COR_PRF_DISABLE_ALL_NGEN_IMAGES is used.

Indicateurs compositesComposite flags

MembreMember DescriptionDescription
COR_PRF_ALL Représente toutes valeurs de l'indicateur COR_PRF_MONITOR.Represents all COR_PRF_MONITOR flag values.
COR_PRF_ALLOWABLE_AFTER_ATTACH Représente tous les indicateurs COR_PRF_MONITOR qui peuvent être définis une fois que le profileur est attaché à une application en cours d'exécution.Represents all COR_PRF_MONITOR flags that can be set after the profiler is attached to a running app. La section Syntaxe indique les indicateurs individuels qui sont présents dans ce masque de bits.The syntax section indicates the individual flags that are present in this bitmask.
COR_PRF_MONITOR_ALL Active tous les événements de rappel.Enables all callback events.
COR_PRF_MONITOR_IMMUTABLE Représente tous les indicateurs COR_PRF_MONITOR qui peuvent être définis uniquement lors de l'initialisation.Represents all COR_PRF_MONITOR flags that can be set only during initialization. Les tentatives de modification d'un ou plusieurs de ces indicateurs après l'initialisation retournent une valeur HRESULT, qui indique un échec.Trying to change any of these flags after initialization returns an HRESULT value that indicates failure.
COR_PRF_REQUIRE_PROFILE_IMAGE Représente tous les indicateurs COR_PRF_MONITOR qui requièrent des images à profil optimisé.Represents all COR_PRF_MONITOR flags that require profile-enhanced images.

NotesRemarks

Un COR_PRF_MONITOR valeur est utilisée avec la ICorProfilerInfo::GetEventMask et ICorProfilerInfo::SetEventMask méthodes pour définir les notifications d’événements que le common language runtime effectue vers le profileur.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.

Configuration requiseRequirements

Plateformes : Consultez Configuration requise.Platforms: See System Requirements.

En-tête : CorProf.idl, CorProf.hHeader: CorProf.idl, CorProf.h

Bibliothèque : CorGuids.libLibrary: CorGuids.lib

Versions du .NET Framework : Disponible à partir de 1.0Available since 1.0.NET Framework Versions: Disponible à partir de 1.0Available since 1.0

Voir aussiSee also