COR_PRF_HIGH_MONITOR-Enumeration

  • Artikel

[Wird nur in .NET Framework 4.5.2 und neueren Versionen unterstützt]

Stellt Kennzeichen neben denjenigen zur Verfügung, die in der COR_PRF_MONITOR-Enumeration enthalten sind, die der Profiler für die ICorProfilerInfo5::SetEventMask2-Methode festlegen kann, wenn sie geladen wird.

Syntax

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;

Member

Member BESCHREIBUNG
COR_PRF_HIGH_MONITOR_NONE Es sind keine Flags festgelegt.
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES Steuert den ICorProfilerCallback6::GetAssemblyReference-Rückruf für das Hinzufügen von Assemblyverweisen während des Assemblyverweis-Abschlussdurchlaufs der CLR.
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED Steuert den ICorProfilerCallback7::ModuleInMemorySymbolsUpdated-Rückruf für Updates des Symboldatenstroms, der einem In-Memory-Modul zugeordnet ist.
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS Steuert den ICorProfilerCallback9::DynamicMethodUnloaded-Rückruf, der angibt, wann eine Garbage Collection auf eine dynamische Methode angewendet und sie entladen wurde.
Verfügbar seit 4.7.2
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION Nur .NET Core 3.0 und höhere Versionen: Deaktiviert die mehrstufige Kompilierung für Profiler.
COR_PRF_HIGH_BASIC_GC Nur .NET Core 3.0 und höhere Versionen: Bietet eine einfache GC-Profilerstellungsoption im Vergleich zu COR_PRF_MONITOR_GC. Steuert nur die GarbageCollectionStarted-, GarbageCollectionFinished- und GetGenerationBounds-Rückrufe. Im Gegensatz zum COR_PRF_MONITOR_GC-Flag deaktiviert COR_PRF_HIGH_BASIC_GC die gleichzeitige Garbage Collection nicht.
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS Nur .NET Core 3.0 und höhere Versionen: Aktiviert die MovedReferences- und MovedReferences2-Rückrufe nur für das Komprimieren von GCs.
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED Nur .NET Core 3.0 und höhere Versionen: Ähnlich wie COR_PRF_MONITOR_OBJECT_ALLOCATED, stellt jedoch nur Informationen zu Objektzuordnungen für den großen Objektheap (LOH) bereit.
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE Stellt alle COR_PRF_HIGH_MONITOR-Flags dar, die durch Profiler verbesserte Bilder erfordern. Entspricht dem COR_PRF_REQUIRE_PROFILE_IMAGE-Flag in der COR_PRF_MONITOR-Enumeration.
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH Stellt alle COR_PRF_HIGH_MONITOR-Flags dar, die festgelegt werden können, wenn der Profiler mit einer ausgeführten App verknüpft wurde.
COR_PRF_HIGH_MONITOR_IMMUTABLE Stellt alle COR_PRF_HIGH_MONITOR-Flags dar, die nur während der Initialisierung festgelegt werden können. Wenn Sie versuchen, eines dieser Flags an einem anderen Ort zu ändern, führt dies zu einem HRESULT-Wert, der auf einen Fehler hinweist.

Bemerkungen

Die COR_PRF_HIGH_MONITOR-Flags werden mit dem pdwEventsHigh-Parameter der ICorProfilerInfo5::GetEventMask2- und ICorProfilerInfo5::SetEventMask2-Methoden verwendet.

Ab dem .NET Framework 4.6.1 änderte sich der Wert von COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH von 0 in COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002). Ab dem .NET Framework 4.7.2 änderte sich der Wert von COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED in COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED | COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS.

COR_PRF_HIGH_MONITOR_IMMUTABLE ist als Bitmaske gedacht, die alle Flags darstellt, die nur während der Initialisierung festgelegt werden können. Wenn Sie versuchen, eines dieser Flags an einem anderen Ort zu ändern, führt dies zu einem fehlerhaften HRESULT.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: seit Version 4.5.2 verfügbar

Siehe auch