Compartilhar via

Enumeração COR_PRF_HIGH_MONITOR

  • Artigo

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

Fornece sinalizadores além dos encontrados na enumeração COR_PRF_MONITOR que o criador de perfis pode especificar para o método IICorProfilerInfo5::SetEventMask2 quando estiver carregando.

Sintaxe

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 DESCRIÇÃO
COR_PRF_HIGH_MONITOR_NONE Nenhum sinalizador está definido.
COR_PRF_HIGH_ADD_ASSEMBLY_REFERENCES Controla o retorno de chamada IICorProfilerCallback6::GetAssemblyReference para incluir referências de assembly durante o percurso de fechamento da referência de assembly CLR.
COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED Controla o retorno de chamada ICorProfilerCallback7::ModuleInMemorySymbolsUpdated para atualizações no fluxo de símbolos associado a um módulo na memória.
COR_PRF_HIGH_MONITOR_DYNAMIC_FUNCTION_UNLOADS Controla o retorno de chamada ICorProfilerCallback9::D ynamicMethodUnloaded para indicar quando um método dinâmico foi coletado e descarregado.
Disponível desde o 4.7.2
COR_PRF_HIGH_DISABLE_TIERED_COMPILATION Somente versões do .NET Core 3.0 e posteriores: desabilita a compilação em camadas para criadores de perfil.
COR_PRF_HIGH_BASIC_GC Somente versões do .NET Core 3.0 e posteriores: fornece uma opção leve de criação de perfil do GC em comparação com COR_PRF_MONITOR_GC. Controla apenas os retornos de chamada GarbageCollectionStarted, GarbageCollectionFinished e GetGenerationBounds . Ao contrário do sinalizador COR_PRF_MONITOR_GC, COR_PRF_HIGH_BASIC_GC não desabilita a coleta de lixo simultânea.
COR_PRF_HIGH_MONITOR_GC_MOVED_OBJECTS Somente versões do .NET Core 3.0 e posteriores: habilita os retornos de chamada MovedReferences e MovedReferences2 apenas para compactação de GCs.
COR_PRF_HIGH_MONITOR_LARGEOBJECT_ALLOCATED Somente versões do .NET Core 3.0 e posteriores: semelhantes a COR_PRF_MONITOR_OBJECT_ALLOCATED, mas fornece informações sobre alocações de objeto somente para loh (heap de objetos grandes).
COR_PRF_HIGH_REQUIRE_PROFILE_IMAGE Representa todos os sinalizadores COR_PRF_HIGH_MONITOR que necessitam de imagens aprimoradas por perfil. Corresponde ao sinalizador COR_PRF_REQUIRE_PROFILE_IMAGE na enumeração COR_PRF_MONITOR.
COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH Representa todos os sinalizadores COR_PRF_HIGH_MONITOR que podem ser definidos após o criador de perfis ser anexado a um aplicativo em execução.
COR_PRF_HIGH_MONITOR_IMMUTABLE Representa todos os sinalizadores COR_PRF_HIGH_MONITOR que podem ser definidos apenas durante a inicialização. Tentar alterar qualquer um desses sinalizadores em outro lugar resulta em um valor de HRESULT que indica falha.

Comentários

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

Começando com o .NET Framework 4.6.1, o valor do COR_PRF_HIGH_ALLOWABLE_AFTER_ATTACH mudou de zero 0 para COR_PRF_HIGH_IN_MEMORY_SYMBOLS_UPDATED (0x00000002). A partir do .NET Framework 4.7.2, seu valor foi alterado 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 desses sinalizadores em outro lugar resulta em um HRESULT com falha.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4.5.2

Confira também