COR_PRF_HIGH_MONITOR (Enumeración)

  • Artículo

[Compatible con .NET Framework 4.5.2 y versiones posteriores]

Proporciona otras marcas, además de las que se encuentran en la enumeración COR_PRF_MONITOR, que el generador de perfiles puede especificar al método ICorProfilerInfo5::SetEventMask2 cuando se está cargando.

Sintaxis

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;

Miembros

Miembro Descripción
COR_PRF_HIGH_MONITOR_NONE No se establecen marcas.
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES Controla la devolución de llamada ICorProfilerCallback6::GetAssemblyReference para agregar referencias de ensamblado durante el rastreo de cierre de referencias de ensamblado de CLR.
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED Controla la llamada de retorno ICorProfilerCallback7::ModuleInMemorySymbolsUpdated para actualizar el flujo de símbolos asociado a un módulo en memoria.
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS Controla el callback ICorProfilerCallback9::DynamicMethodUnloaded para indicar cuando un método dinámico ha sido recolectado y descargado.
Disponible desde la versión 4.7.2
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION Solo .NET Core 3.0 y versiones posteriores: deshabilita la compilación por niveles para los generadores de perfiles.
COR_PRF_HIGH_BASIC_GC Solo .NET Core 3.0 y versiones posteriores: proporciona una opción de generación de perfiles de GC ligera en comparación con COR_PRF_MONITOR_GC. Controla solo las devoluciones de llamada GarbageCollectionStarted, GarbageCollectionFinished y GetGenerationBounds. A diferencia de la marca COR_PRF_MONITOR_GC, COR_PRF_HIGH_BASIC_GC no deshabilita la recolección simultánea de elementos no utilizados.
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS Solo .NET Core 3.0 y versiones posteriores: habilita las devoluciones de llamada MovedReferences y MovedReferences2 solo para compactar los GCs.
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED Solo .NET Core 3.0 y versiones posteriores: similar a COR_PRF_MONITOR_OBJECT_ALLOCATED, pero proporciona información sobre las asignaciones de objetos solo para el montón de objetos grandes (LOH).
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE Representa todas las marcas COR_PRF_HIGH_MONITOR que requieren imágenes mejoradas para el perfil. Se corresponde con la marca COR_PRF_REQUIRE_PROFILE_IMAGE de la enumeración COR_PRF_MONITOR.
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH Representa todas las marcas COR_PRF_HIGH_MONITOR que se pueden establecer después de que el generador de perfiles se asocie a una aplicación en ejecución.
COR_PRF_HIGH_MONITOR_IMMUTABLE Representa todas las marcas COR_PRF_HIGH_MONITOR que se pueden establecer solo durante la inicialización. Al intentar cambiar cualquiera de estas marcas en otro lugar se genera un valor HRESULT que indica error.

Comentarios

Las marcas COR_PRF_HIGH_MONITOR se usan con el parámetro pdwEventsHigh de los métodos ICorProfilerInfo5::GetEventMask2 y ICorProfilerInfo5::SetEventMask2.

A partir de .NET Framework 4.6.1, el valor de COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH ha cambiado de 0 a COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002). A partir de .NET Framework 4.7.2, su valor cambió de 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 está pensado para ser una máscara de bits que representa todas las marcas que solo se pueden establecer durante la inicialización. Si se intenta cambiar alguna de estas marcas en otro lugar, se produce un error HRESULT.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versiones de .NET Framework: disponible a partir de la versión 4.5.2

Consulte también