COR_PRF_MONITOR, énumération

Article
05/10/2023

Contient des valeurs utilisées pour spécifier un comportement, des fonctionnalités ou des événements auxquels le profileur veut s'abonner.

Syntaxe

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;

Membres

Les sections suivantes répertorient COR_PRF_MONITOR membres d’énumération par catégorie. Les catégories sont les suivantes :

Aucun indicateur défini
Indicateurs de rappel
Indicateurs d’activation de fonctionnalité
Indicateurs de configuration
Indicateurs composites

Aucun indicateur défini.

Membre	Description
`COR_PRF_MONITOR_NONE`	Aucun indicateur n'est défini.

Indicateurs de rappel

Membre	Description
`COR_PRF_MONITOR_ALL`	Active tous les événements de rappel.
`COR_PRF_MONITOR_APPDOMAIN_LOADS`	Contrôle les rappels `AppDomainCreation` et `AppDomainShutdown` dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_ASSEMBLY_LOADS`	Contrôle les rappels `AssemblyLoad` et `AssemblyUnload` dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_CACHE_SEARCHES`	Contrôle les rappels `JITCachedFunctionSearch*` dans l’interface ICorProfilerCallback. Le comportement de cet indicateur est changé dans .NET Framework version 2.0.
`COR_PRF_MONITOR_CCW`	Contrôle les rappels `COMClassicVTable*` dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_CLASS_LOADS`	Contrôle les rappels `ClassLoad` et `ClassUnload` dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_CLR_EXCEPTIONS`	Contrôle les rappels `ExceptionCLRCatcher*` dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_CODE_TRANSITIONS`	Contrôle les rappels UnmanagedToManagedTransition et ManagedToUnmanagedTransition dans l’interface ICorProfilerCallback
`COR_PRF_MONITOR_ENTERLEAVE`	Contrôle `FunctionEnter`, `FunctionLeave` et les `FunctionTailCall*`fonctions statiques globales de profilage.
`COR_PRF_MONITOR_EXCEPTIONS`	Contrôle le rappel ExceptionThrown et les rappels `ExceptionSearch`, `ExceptionOSHandler`, `ExceptionUnwind` et `ExceptionCatcher` dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_FUNCTION_UNLOADS`	Contrôle le rappel de FunctionUnloadStarted dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_GC`	Contrôle les rappels GarbageCollectionStarted, GarbageCollectionFinished, MovedReferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, ObjectsAllocatedByClass, RootReferences, RootReferences2, HandleCreated, HandleDestroyed et FinalizeableObjectQueued dans les interfaces `ICorProfilerCallback*`. Lorsque `COR_PRF_MONITOR_GC` est alloué, le garbage collection simultané est désactivé.
`COR_PRF_MONITOR_JIT_COMPILATION`	Contrôle les rappels `JITCompilation*`, JITFunctionPitched et JITInlining dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_MODULE_LOADS`	Contrôle les rappels `ModuleLoad`, `ModuleUnload` et ModuleAttachedToAssembly dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_OBJECT_ALLOCATED`	Contrôle le rappel ObjectAllocated dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_REMOTING`	Contrôle les rappels `Remoting*` dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_REMOTING_ASYNC`	Contrôle si les rappels `Remoting*` surveillent les événements asynchrones.
`COR_PRF_MONITOR_REMOTING_COOKIE`	Contrôle si un cookie est passé aux rappels `Remoting*`.
`COR_PRF_MONITOR_SUSPENDS`	Contrôle les rappels `RuntimeSuspend`, `RuntimeResume`, RuntimeThreadSuspended et RuntimeThreadResumed dans l’interface ICorProfilerCallback.
`COR_PRF_MONITOR_THREADS`	Contrôle les rappels ThreadCreated, ThreadDestroyed, ThreadAssignedToOSThreadet ThreadNameChanged dans les interfaces ICorProfilerCallback et ICorProfilerCallback2.

Indicateurs d’activation de fonctionnalité

Membre	Description
`COR_PRF_ENABLE_FRAME_INFO`	Active la récupération d’un `ClassID` exact pour une fonction générique en appelant la méthode GetFunctionInfo2 avec une valeur `COR_PRF_FRAME_INFO` retournée par le rappel de FunctionEnter2.
`COR_PRF_ENABLE_FUNCTION_ARGS`	Active le suivi d’arguments à l’aide du rappel FunctionEnter2 ou du rappel FunctionEnter3WithInfo et de la méthode GetFunctionEnter3Info.
`COR_PRF_ENABLE_FUNCTION_RETVAL`	Active le suivi des valeurs de retour à l’aide du rappel FunctionLeave2 ou du rappel FunctionLeave3WithInfo et de la méthode GetFunctionLeave3Info.
`COR_PRF_ENABLE_INPROC_DEBUGGING`	Action déconseillée. Le débogage in-process n'est pas pris en charge. Cet indicateur est sans effet.
`COR_PRF_ENABLE_JIT_MAPS`	Action déconseillée. Permet au profileur d’obtenir des mappes Langage intermédiaire – Natif en utilisant 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.
`COR_PRF_ENABLE_OBJECT_ALLOCATED`	Informe le runtime que le profileur est susceptible de demander l'allocation d'objets. Cet indicateur doit être défini lors de l'initialisation. Il permet au profileur d’utiliser ensuite l’indicateur `COR_PRF_MONITOR_OBJECT_ALLOCATED` pour recevoir des rappels ObjectAllocated.
`COR_PRF_ENABLE_REJIT`	Active les appels aux méthodes RequestReJIT et RequestRevert. Le profileur doit définir cet indicateur au démarrage. Si le profileur spécifie cet indicateur, il doit aussi spécifier `COR_PRF_DISABLE_ALL_NGEN_IMAGES`.
`COR_PRF_ENABLE_STACK_SNAPSHOT`	Active les appels à la méthode DoStackSnapshot.

Indicateurs de configuration

Membre	Description
`COR_PRF_DISABLE_ALL_NGEN_IMAGES`	Empêche le chargement de toutes les images natives (y compris les images optimisées par le profileur). 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é.
`COR_PRF_DISABLE_INLINING`	Désactive toutes les incorporations.
`COR_PRF_DISABLE_OPTIMIZATIONS`	Désactive toutes les optimisations du code.
`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. Ceci peut rendre certaines instrumentations plus faciles à effectuer.
`COR_PRF_USE_PROFILE_IMAGES`	Fait que la recherche d'images natives s'effectue dans les images optimisées par le profileur. 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. 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é.

Indicateurs composites

Membre	Description
`COR_PRF_ALL`	Représente toutes valeurs de l'indicateur `COR_PRF_MONITOR`.
`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. La section Syntaxe indique les indicateurs individuels qui sont présents dans ce masque de bits.
`COR_PRF_MONITOR_ALL`	Active tous les événements de rappel.
`COR_PRF_MONITOR_IMMUTABLE`	Représente tous les indicateurs `COR_PRF_MONITOR` qui peuvent être définis uniquement lors de l'initialisation. Les tentatives de modification d'un ou plusieurs de ces indicateurs après l'initialisation retournent une valeur `HRESULT`, qui indique un échec.
`COR_PRF_REQUIRE_PROFILE_IMAGE`	Représente tous les indicateurs `COR_PRF_MONITOR` qui requièrent des images à profil optimisé.

Notes

Une valeur COR_PRF_MONITOR est utilisée avec les méthodes ICorProfilerInfo::GetEventMask et ICorProfilerInfo::SetEventMask pour définir les notifications d’événements faites par le CLR (Common Language Runtime) au profileur.

Spécifications

Plateformes : Consultez Configuration requise.

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

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible à partir de la version 1.0

Partager via