Enumerazione COR_PRF_HIGH_MONITOR

  • Articolo

[Supportato in .NET Framework 4.5.2 e versioni successive]

Fornisce flag oltre a quelli presenti nell'enumerazione COR_PRF_MONITOR che il profiler può specificare per il metodo ICorProfilerInfo5::SetEventMask2 durante il caricamento.

Sintassi

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;

Members

Membro Descrizione
COR_PRF_HIGH_MONITOR_NONE Nessun flag impostato.
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES Controlla il callback ICorProfilerCallback6::GetAssemblyReference per l'aggiunta di riferimenti all'assembly durante la procedura di chiusura del riferimento all'assembly CLR.
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED Controlla il callback ICorProfilerCallback7::ModuleInMemorySymbolsUpdated per gli aggiornamenti al flusso di simboli associato a un modulo in memoria.
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS Controlla il callback ICorProfilerCallback9::D ynamicMethodUnloaded per indicare quando un metodo dinamico è stato sottoposto a Garbage Collection e scaricato.
Disponibile dalla 4.7.2
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION Solo .NET Core 3.0 e versioni successive: disabilita la compilazione a livelli per i profiler.
COR_PRF_HIGH_BASIC_GC Solo .NET Core 3.0 e versioni successive: offre un'opzione di profilatura GC leggera rispetto a COR_PRF_MONITOR_GC. Controlla solo i callback GarbageCollectionStarted, GarbageCollectionFinished e GetGenerationBounds . A differenza del flag, COR_PRF_HIGH_BASIC_GC non disabilita l'operazione COR_PRF_MONITOR_GC di Garbage Collection simultanea.
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS Solo .NET Core 3.0 e versioni successive: abilita i callback MovedReferences e MovedReferences2 solo per la compattazione dei controller di dominio.
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED Solo .NET Core 3.0 e versioni successive: simile a COR_PRF_MONITOR_OBJECT_ALLOCATED, ma fornisce informazioni sulle allocazioni di oggetti solo per l'heap di oggetti di grandi dimensioni (LOH).
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE Rappresenta tutti i flag COR_PRF_HIGH_MONITOR che richiedono le immagini ottimizzate per il profiler. Corrisponde al COR_PRF_REQUIRE_PROFILE_IMAGE flag nell'enumerazione COR_PRF_MONITOR .
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH Rappresenta tutti i flag COR_PRF_HIGH_MONITOR che possono essere impostati dopo la connessione del profiler a un'applicazione in esecuzione.
COR_PRF_HIGH_MONITOR_IMMUTABLE Rappresenta tutti i flag COR_PRF_HIGH_MONITOR che possono essere impostati solo durante l'inizializzazione. Se si prova a modificare uno di questi flag altrove, viene restituito un valore HRESULT che indica un errore.

Commenti

I COR_PRF_HIGH_MONITOR flag vengono usati con il pdwEventsHigh parametro dei metodi ICorProfilerInfo5::GetEventMask2 e ICorProfilerInfo5::SetEventMask2 .

A partire da .NET Framework 4.6.1, il valore di COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH è cambiato da 0 a COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002). A partire da .NET Framework 4.7.2, il relativo valore è stato modificato da COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED a COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED | COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS.

COR_PRF_HIGH_MONITOR_IMMUTABLE deve essere una maschera di bit che rappresenta tutti i flag che possono essere impostati solo durante l'inizializzazione. Se si tenta di modificare uno di questi flag in un'altra posizione, viene restituito un errore HRESULT.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile dalla versione 4.5.2

Vedi anche