Partager via

COR_PRF_MODULE_FLAGS, énumération

  • Article

[Pris en charge dans .NET Framework 4.5.2 et ultérieur]

Fournit des indicateurs en plus de ceux inclus dans l’énumération COR_PRF_MONITOR que le profileur peut spécifier à la méthode ICorProfilerInfo5::SetEventMask2 lors de son chargement.

Syntaxe

typedef enum {  
    COR_PRF_HIGH_MONITOR_NONE                     = 0x00000000,  
    COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES          = 0x00000001,  
    COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED        = 0x00000002,
    COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS = 0x00000004,
    COR_PRF_HIGH_DISABLE_TIERED_COMPILATION       = 0x00000008,
    COR_PRF_HIGH_BASIC_GC                         = 0x00000010,
    COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS         = 0x00000020,
    COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED    = 0x00000040,
    COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE            = 0,  
    COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH           = COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED |
                                                    COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS |
                                                    COR_PRF_HIGH_BASIC_GC |
                                                    COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS |
                                                    COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED,  
    COR_PRF_HIGH_MONITOR_IMMUTABLE                = COR_PRF_HIGH_DISABLE_TIERED_COMPILATION  
} COR_PRF_HIGH_MONITOR;

Membres

Membre Description
COR_PRF_HIGH_MONITOR_NONE Aucun indicateur n'est défini.
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES Contrôle le rappel de ICorProfilerCallback6::GetAssemblyReference quant à l’ajout de références d’assembly durant le parcours de fermeture des références d’assembly CLR.
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED Contrôle le rappel ICorProfilerCallback7::ModuleInMemorySymbolsUpdated pour les mises à jour du flux de symboles associé à un module en mémoire.
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS Contrôle le rappel ICorProfilerCallback9::DynamicMethodUnloaded pour indiquer quand une méthode dynamique a été récupérée et déchargée.
Disponible depuis la version 4.7.2
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION .NET Core 3.0 et versions ultérieures uniquement : désactive la compilation hiérarchisée pour les profileurs.
COR_PRF_HIGH_BASIC_GC .NET Core 3.0 et versions ultérieures uniquement : fournit une option de profilage GC légère par rapport à COR_PRF_MONITOR_GC. Contrôle uniquement les rappels GarbageCollectionStarted, GarbageCollectionFinished et GetGenerationBounds. Contrairement à l’indicateur COR_PRF_MONITOR_GC, COR_PRF_HIGH_BASIC_GC ne désactive pas le garbage collection simultané.
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS .NET Core 3.0 et versions ultérieures uniquement : active uniquement les rappels MovedReferences et MovedReferences2 pour le compactage des GC.
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED .NET Core 3.0 et versions ultérieures uniquement : similaire à COR_PRF_MONITOR_OBJECT_ALLOCATED, mais fournit des informations sur les allocations d’objets pour le tas d’objets volumineux (LOH) uniquement.
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE Représente tous les indicateurs COR_PRF_HIGH_MONITOR qui requièrent des images à profil optimisé. Il correspond à l’indicateur COR_PRF_REQUIRE_PROFILE_IMAGE de l’énumération COR_PRF_MONITOR.
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH Représente tous les indicateurs COR_PRF_HIGH_MONITOR qui peuvent être définis une fois que le profileur est attaché à une application en cours d'exécution.
COR_PRF_HIGH_MONITOR_IMMUTABLE Représente tous les indicateurs COR_PRF_HIGH_MONITOR qui peuvent être définis uniquement lors de l'initialisation. Les tentatives de modification d'un ou plusieurs de ces indicateurs autre part génèrent une valeur HRESULT, qui indique un échec.

Notes

Les indicateurs COR_PRF_HIGH_MONITOR sont utilisés avec le paramètre pdwEventsHigh des méthodes ICorProfilerInfo5::GetEventMask2 et ICorProfilerInfo5::SetEventMask2.

À compter du .NET Framework 4.6.1, la valeur de COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH est passée de 0 à COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002). À compter de .NET Framework 4.7.2, sa valeur est passée de COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED à COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED | COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS.

COR_PRF_HIGH_MONITOR_IMMUTABLE est destiné à être un masque de bits qui représente tous les indicateurs qui ne peuvent être définis qu’au cours de l’initialisation. La tentative de modification de ces indicateurs ailleurs entraîne un échec de HRESULT.

Spécifications

Plateformes : Consultez Configuration requise.

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

Bibliothèque : CorGuids.lib

Versions du .NET Framework : Disponibles depuis la version 4.5.2

Voir aussi