Enumeração de COR_PRF_HIGH_MONITOR

  • Artigo

[Suportado no .NET Framework 4.5.2 e versões posteriores]

Fornece sinalizadores para além dos que se encontram na enumeração COR_PRF_MONITOR que o gerador de perfis pode especificar para o método ICorProfilerInfo5::SetEventMask2 quando está a carregar.

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;

Membros

Membro Description
COR_PRF_HIGH_MONITOR_NONE Não são definidos sinalizadores.
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES Controla a chamada de retorno ICorProfilerCallback6::GetAssemblyReference para adicionar referências de assemblagem durante a caminhada de fecho da referência de assemblagem CLR.
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED Controla a chamada de retorno ICorProfilerCallback7::ModuleInMemorySymbolsUpdated para obter atualizações para o fluxo de símbolos associado a um módulo dentro da memória.
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS Controla a chamada de retorno ICorProfilerCallback9::D ynamicMethodUnloaded para indicar quando um método dinâmico foi recolhido e descarregado.
Disponível desde 4.7.2
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION .NET Core 3.0 e versões posteriores apenas: desativa a compilação em camadas para geradores de perfis.
COR_PRF_HIGH_BASIC_GC Apenas .NET Core 3.0 e versões posteriores: fornece uma opção de criação de perfis GC simples em comparação COR_PRF_MONITOR_GCcom . Controla apenas as chamadas de retorno GarbageCollectionStarted, GarbageCollectionFinished e GetGenerationBounds . Ao contrário do COR_PRF_MONITOR_GC sinalizador, COR_PRF_HIGH_BASIC_GC não desativa a libertação da memória simultânea.
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS .NET Core 3.0 e versões posteriores apenas: ativa as chamadas de retorno MovedReferences e MovedReferences2 apenas para compactar GCs.
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED .NET Core 3.0 e versões posteriores apenas: semelhante a COR_PRF_MONITOR_OBJECT_ALLOCATED, mas fornece informações sobre alocações de objetos apenas para a área dinâmica para dados de objetos grandes (LOH).
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE Representa todos os COR_PRF_HIGH_MONITOR sinalizadores que requerem imagens melhoradas para perfis. Corresponde ao sinalizador COR_PRF_REQUIRE_PROFILE_IMAGE na enumeração COR_PRF_MONITOR .
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH Representa todos os COR_PRF_HIGH_MONITOR sinalizadores que podem ser definidos após o gerador de perfis ser anexado a uma aplicação em execução.
COR_PRF_HIGH_MONITOR_IMMUTABLE Representa todos os COR_PRF_HIGH_MONITOR sinalizadores que só podem ser definidos durante a inicialização. Tentar alterar qualquer um destes sinalizadores noutro local resulta num HRESULT valor que indica uma falha.

Observações

Os COR_PRF_HIGH_MONITOR sinalizadores são utilizados com o pdwEventsHigh parâmetro dos métodos ICorProfilerInfo5::GetEventMask2 e ICorProfilerInfo5::SetEventMask2 .

A partir do .NET Framework 4.6.1, o valor do COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH foi alterado de 0 para COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002). A partir do .NET Framework 4.7.2, o respetivo valor mudou de COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED para COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED | COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS.

COR_PRF_HIGH_MONITOR_IMMUTABLE destina-se a ser uma máscara de bits que representa todos os sinalizadores que só podem ser definidos durante a inicialização. Tentar alterar qualquer um destes sinalizadores noutro local resulta numa falha HRESULT.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

.NET Framework Versões: Disponível desde a versão 4.5.2

Ver também