Wyliczenie COR_PRF_HIGH_MONITOR

  • Artykuł

[Obsługiwane w wersji .NET Framework 4.5.2 i nowszych]

Udostępnia flagi oprócz tych znalezionych w COR_PRF_MONITOR wyliczenie, które profiler może określić dla metody ICorProfilerInfo5::SetEventMask2 podczas ładowania.

Składnia

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;

Elementy członkowskie

Członek Opis
COR_PRF_HIGH_MONITOR_NONE Nie ustawiono żadnych flag.
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES Steruje wywołaniem zwrotnym ICorProfilerCallback6::GetAssemblyReference w celu dodania odwołań do zestawów podczas przewodnika zamknięcia odwołania do zestawu CLR.
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED Steruje wywołaniem zwrotnym ICorProfilerCallback7::ModuleInMemorySymbolsUpdatedUpdated pod kątem aktualizacji strumienia symboli skojarzonego z modułem w pamięci.
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS Steruje wywołaniem zwrotnym ICorProfilerCallback9::D ynamicMethodUnloaded w celu wskazania, kiedy metoda dynamiczna została odebrana i zwolniona.
Dostępne od wersji 4.7.2
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION Tylko wersje programu .NET Core 3.0 i nowszych: wyłącza kompilację warstwową dla profilatorów.
COR_PRF_HIGH_BASIC_GC Tylko wersje platformy .NET Core 3.0 i nowszych: zapewnia uproszczoną opcję profilowania GC w porównaniu do COR_PRF_MONITOR_GC. Kontroluje tylko wywołania zwrotne GarbageCollectionStarted, GarbageCollectionFinished i GetGenerationBounds . W przeciwieństwie do flagi COR_PRF_MONITOR_GC nie COR_PRF_HIGH_BASIC_GC wyłącza współbieżnego odzyskiwania pamięci.
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS Tylko wersje platformy .NET Core 3.0 i nowsze: włącza tylko wywołania zwrotne MovedReferences i MovedReferences2 na potrzeby kompaktowania kontrolerów domeny.
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED Tylko wersje platformy .NET Core 3.0 i nowszych: podobne do COR_PRF_MONITOR_OBJECT_ALLOCATED, ale zawierają informacje na temat alokacji obiektów tylko dla dużego sterty obiektów (LOH).
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE Reprezentuje wszystkie COR_PRF_HIGH_MONITOR flagi, które wymagają obrazów rozszerzonych profilami. Odpowiada on flagi COR_PRF_REQUIRE_PROFILE_IMAGE w wyliczeniem COR_PRF_MONITOR .
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH Reprezentuje wszystkie COR_PRF_HIGH_MONITOR flagi, które można ustawić po dołączeniu profilera do uruchomionej aplikacji.
COR_PRF_HIGH_MONITOR_IMMUTABLE Reprezentuje wszystkie COR_PRF_HIGH_MONITOR flagi, które można ustawić tylko podczas inicjowania. Próba zmiany dowolnej z tych flag w innym miejscu powoduje wyświetlenie wartości wskazującej HRESULT błąd.

Uwagi

Flagi COR_PRF_HIGH_MONITOR są używane z parametrem pdwEventsHigh metod ICorProfilerInfo5::GetEventMask2 i ICorProfilerInfo5::SetEventMask2 .

Począwszy od .NET Framework 4.6.1, wartość COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH zmieniona z 0 na COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002). Począwszy od .NET Framework 4.7.2, jego wartość zmieniła się z COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED na COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED | COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS.

COR_PRF_HIGH_MONITOR_IMMUTABLE ma być maską bitową reprezentującą wszystkie flagi, które można ustawić tylko podczas inicjowania. Próba zmiany dowolnej z tych flag w innym miejscu powoduje niepowodzenie HRESULT.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorProf.idl, CorProf.h

Biblioteki: CorGuids.lib

.NET Framework wersje: dostępne od wersji 4.5.2

Zobacz też