Enumeração COR_PRF_MONITOR

Artigo
05/10/2023

Contém valores usados para especificar comportamentos, recursos ou eventos que o criador de perfis deseja assinar.

Sintaxe

typedef enum {  
    COR_PRF_MONITOR_NONE                = 0x00000000,  
    COR_PRF_MONITOR_FUNCTION_UNLOADS    = 0x00000001,  
    COR_PRF_MONITOR_CLASS_LOADS         = 0x00000002,  
    COR_PRF_MONITOR_MODULE_LOADS        = 0x00000004,  
    COR_PRF_MONITOR_ASSEMBLY_LOADS      = 0x00000008,  
    COR_PRF_MONITOR_APPDOMAIN_LOADS     = 0x00000010,  
    COR_PRF_MONITOR_JIT_COMPILATION     = 0x00000020,  
    COR_PRF_MONITOR_EXCEPTIONS          = 0x00000040,  
    COR_PRF_MONITOR_GC                  = 0x00000080,  
    COR_PRF_MONITOR_OBJECT_ALLOCATED    = 0x00000100,  
    COR_PRF_MONITOR_THREADS             = 0x00000200,  
    COR_PRF_MONITOR_REMOTING            = 0x00000400,  
    COR_PRF_MONITOR_CODE_TRANSITIONS    = 0x00000800,  
    COR_PRF_MONITOR_ENTERLEAVE          = 0x00001000,  
    COR_PRF_MONITOR_CCW                 = 0x00002000,  
    COR_PRF_MONITOR_REMOTING_COOKIE     = 0x00004000 |
                                          COR_PRF_MONITOR_REMOTING,  
    COR_PRF_MONITOR_REMOTING_ASYNC      = 0x00008000 |
                                          COR_PRF_MONITOR_REMOTING,  
    COR_PRF_MONITOR_SUSPENDS            = 0x00010000,  
    COR_PRF_MONITOR_CACHE_SEARCHES      = 0x00020000,  
    COR_PRF_ENABLE_REJIT                = 0x00040000,  
    COR_PRF_ENABLE_INPROC_DEBUGGING     = 0x00080000,  
    COR_PRF_ENABLE_JIT_MAPS             = 0x00100000,  
    COR_PRF_DISABLE_INLINING            = 0x00200000,  
    COR_PRF_DISABLE_OPTIMIZATIONS       = 0x00400000,  
    COR_PRF_ENABLE_OBJECT_ALLOCATED     = 0x00800000,  
    COR_PRF_MONITOR_CLR_EXCEPTIONS      = 0x01000000,  
    COR_PRF_MONITOR_ALL                 = 0x0107FFFF,  
    COR_PRF_ENABLE_FUNCTION_ARGS        = 0X02000000,  
    COR_PRF_ENABLE_FUNCTION_RETVAL      = 0X04000000,  
    COR_PRF_ENABLE_FRAME_INFO           = 0X08000000,  
    COR_PRF_ENABLE_STACK_SNAPSHOT       = 0X10000000,  
    COR_PRF_USE_PROFILE_IMAGES          = 0x20000000,  
    COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST  
                                        = 0x40000000,  
    COR_PRF_DISABLE_ALL_NGEN_IMAGES     = 0x80000000,  
    COR_PRF_ALL                         = 0x8FFFFFFF,  
    COR_PRF_REQUIRE_PROFILE_IMAGE       = COR_PRF_USE_PROFILE_IMAGES |
                                          COR_PRF_MONITOR_CODE_TRANSITIONS |
                                          COR_PRF_MONITOR_ENTERLEAVE,  
    COR_PRF_ALLOWABLE_AFTER_ATTACH      = COR_PRF_MONITOR_THREADS |  
                                          COR_PRF_MONITOR_MODULE_LOADS |  
                                          COR_PRF_MONITOR_ASSEMBLY_LOADS |  
                                          COR_PRF_MONITOR_APPDOMAIN_LOADS |  
                                          COR_PRF_ENABLE_STACK_SNAPSHOT |  
                                          COR_PRF_MONITOR_GC |  
                                          COR_PRF_MONITOR_SUSPENDS |  
                                          COR_PRF_MONITOR_CLASS_LOADS |  
                                          COR_PRF_MONITOR_JIT_COMPILATION,  
    COR_PRF_MONITOR_IMMUTABLE           = COR_PRF_MONITOR_CODE_TRANSITIONS |  
                                          COR_PRF_MONITOR_REMOTING |  
                                          COR_PRF_MONITOR_REMOTING_COOKIE |  
                                          COR_PRF_MONITOR_REMOTING_ASYNC |  
                                          COR_PRF_ENABLE_REJIT |  
                                          COR_PRF_ENABLE_INPROC_DEBUGGING |  
                                          COR_PRF_ENABLE_JIT_MAPS |  
                                          COR_PRF_DISABLE_OPTIMIZATIONS |  
                                          COR_PRF_DISABLE_INLINING |  
                                          COR_PRF_ENABLE_OBJECT_ALLOCATED |  
                                          COR_PRF_ENABLE_FUNCTION_ARGS |  
                                          COR_PRF_ENABLE_FUNCTION_RETVAL |  
                                          COR_PRF_ENABLE_FRAME_INFO |  
                                          COR_PRF_USE_PROFILE_IMAGES |  
                     COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST |  
                                          COR_PRF_DISABLE_ALL_NGEN_IMAGES  
} COR_PRF_MONITOR;

Membros

As seções a seguir listam membros de enumeração COR_PRF_MONITOR por categoria. As categorias são:

Nenhum sinalizador definido
Sinalizadores de retorno de chamada
Sinalizadores de habilitação de recurso
Sinalizadores de configuração
Sinalizadores compostos

Nenhum sinalizador definido

Membro	DESCRIÇÃO
`COR_PRF_MONITOR_NONE`	Nenhum sinalizador está definido.

Sinalizadores de retorno de chamada

Membro	DESCRIÇÃO
`COR_PRF_MONITOR_ALL`	Habilita todos os eventos de retorno de chamada.
`COR_PRF_MONITOR_APPDOMAIN_LOADS`	Controla os retornos de chamada `AppDomainCreation` e `AppDomainShutdown` na interface ICorProfilerCallback
`COR_PRF_MONITOR_ASSEMBLY_LOADS`	Controla os retornos de chamada `AssemblyLoad` e `AssemblyUnload` na interface ICorProfilerCallback
`COR_PRF_MONITOR_CACHE_SEARCHES`	Controla os retornos de chamada `JITCachedFunctionSearch*` na interface ICorProfilerCallback. O comportamento deste sinalizador é alterado no .NET Framework versão 2.0.
`COR_PRF_MONITOR_CCW`	Controla os retornos de chamada `COMClassicVTable*` na interface ICorProfilerCallback.
`COR_PRF_MONITOR_CLASS_LOADS`	Controla os retornos de chamada `ClassLoad` e `ClassUnload` na interface ICorProfilerCallback.
`COR_PRF_MONITOR_CLR_EXCEPTIONS`	Controla os retornos de chamada `ExceptionCLRCatcher*` na interface ICorProfilerCallback.
`COR_PRF_MONITOR_CODE_TRANSITIONS`	Controla os retornos de chamada UnmanagedToManagedTransition e ManagedToUnmanagedTransition na interface ICorProfilerCallback
`COR_PRF_MONITOR_ENTERLEAVE`	Controla as funções estáticas globais de perfil`FunctionEnter`, `FunctionLeave` e `FunctionTailCall*`.
`COR_PRF_MONITOR_EXCEPTIONS`	Controla o retorno de chamada ExceptionThrown e os retornos de chamada `ExceptionSearch`, `ExceptionOSHandler`, `ExceptionUnwind` e `ExceptionCatcher` na interface ICorProfilerCallback.
`COR_PRF_MONITOR_FUNCTION_UNLOADS`	Controla o retorno de chamada FunctionUnloadStarted na interface ICorProfilerCallback.
`COR_PRF_MONITOR_GC`	Controla os retornos de chamada GarbageCollectionStarted, GarbageCollectionFinished, MovedReferences, MovedReferences2, SurvivingReferences, SurvivingReferences2, ObjectReferences, ObjectsAllocatedByClass, RootReferences, RootReferences2, HandleCreated, HandleDestroyed e FinalizeableObjectQueued nas interfaces `ICorProfilerCallback*`. Quando `COR_PRF_MONITOR_GC` é alocada, a coleta de lixo simultânea é desativada.
`COR_PRF_MONITOR_JIT_COMPILATION`	Controla os retornos de chamada `JITCompilation*`, JITFunctionPitched e JITInlining na interface ICorProfilerCallback.
`COR_PRF_MONITOR_MODULE_LOADS`	Controla os retornos de chamada `ModuleLoad`, `ModuleUnload` e ModuleAttachedToAssembly na interface ICorProfilerCallback.
`COR_PRF_MONITOR_OBJECT_ALLOCATED`	Controla o retorno de chamada ObjectAllocated na interface ICorProfilerCallback.
`COR_PRF_MONITOR_REMOTING`	Controla os retornos de chamada `Remoting*` na interface ICorProfilerCallback.
`COR_PRF_MONITOR_REMOTING_ASYNC`	Controla se os retornos de chamada `Remoting*` vão monitorar ou não os eventos de forma assíncrona.
`COR_PRF_MONITOR_REMOTING_COOKIE`	Controla se um cookie é passado para os retornos de chamada `Remoting*`.
`COR_PRF_MONITOR_SUSPENDS`	Controla os retornos de chamada `RuntimeSuspend`, `RuntimeResume`, RuntimeThreadSuspended e RuntimeThreadResumed na interface ICorProfilerCallback.
`COR_PRF_MONITOR_THREADS`	Controla os retornos de chamada ThreadCreated, ThreadDestroyed, ThreadAssignedToOSThread e ThreadNameChanged nas interfaces ICorProfilerCallback e ICorProfilerCallback2.

Sinalizadores de habilitação de recurso

Membro	DESCRIÇÃO
`COR_PRF_ENABLE_FRAME_INFO`	Habilita a recuperação de um `ClassID` exato para uma função genérica, chamando o método GetFunctionInfo2 com um valor `COR_PRF_FRAME_INFO` retornado pelo retorno de chamada FunctionEnter2.
`COR_PRF_ENABLE_FUNCTION_ARGS`	Permite rastreamento de argumento usando os retornos de chamada FunctionEnter2 ou FunctionEnter3WithInfo e o método GetFunctionEnter3Info.
`COR_PRF_ENABLE_FUNCTION_RETVAL`	Permite o rastreamento de valores retornados usando os retornos de chamada FunctionLeave2 ou FunctionLeave3WithInfo e o método GetFunctionLeave3Info.
`COR_PRF_ENABLE_INPROC_DEBUGGING`	Preterido. Não tem suporte no processo de depuração. Este sinalizador não tem efeito.
`COR_PRF_ENABLE_JIT_MAPS`	Preterido. Permite que o criador de perfil obtenha mapas IL para nativo usando GetILToNativeMapping. Do .NET Framework 2.0 em diante, o runtime sempre acompanha os mapas IL para nativo, portanto, esse sinalizador é sempre considerado como definido.
`COR_PRF_ENABLE_OBJECT_ALLOCATED`	Informa o runtime que o criador de perfil pode desejar para notificações de alocação do objeto. Este sinalizador deve ser definido durante a inicialização. Permite que o criador de perfil use posteriormente o sinalizador `COR_PRF_MONITOR_OBJECT_ALLOCATED` para receber retornos de chamada de ObjectAllocated.
`COR_PRF_ENABLE_REJIT`	Permite chamadas para os métodos RequestReJIT e RequestRevert. O criador de perfil deve definir este sinalizador na inicialização. Se o criador de perfil especificar este sinalizador, também deverá especificar `COR_PRF_DISABLE_ALL_NGEN_IMAGES`.
`COR_PRF_ENABLE_STACK_SNAPSHOT`	Permite chamadas para o método DoStackSnapshot.

Sinalizadores de configuração

Membro	DESCRIÇÃO
`COR_PRF_DISABLE_ALL_NGEN_IMAGES`	Impede o carregamento de todas as imagens nativas (incluindo imagens aprimoradas do criador de perfil). Se este sinalizador e o sinalizador `COR_PRF_USE_PROFILE_IMAGES` estiverem especificados, `COR_PRF_DISABLE_ALL_NGEN_IMAGES` será usado.
`COR_PRF_DISABLE_INLINING`	Desabilita todas as conexões embutidas.
`COR_PRF_DISABLE_OPTIMIZATIONS`	Desabilita todas as otimizações de código.
`COR_PRF_DISABLE_TRANSPARENCY_CHECKS_UNDER_FULL_TRUST`	Desabilita verificações de transparência de segurança que normalmente são feitas durante a compilação JIT (Just-in-Time) e o carregamento de classe para os conjuntos de confiança total. Isso pode facilitar a execução de instrumentação.
`COR_PRF_USE_PROFILE_IMAGES`	Faz com que a imagem nativa procure imagens aprimoradas para o criador de perfil. Se nenhuma imagem aprimorada para o criador de perfil for encontrada para determinada montagem, o Common Language Runtime (CRL) retornará ao JIT para esse assembly. Se este sinalizador e o sinalizador `COR_PRF_DISABLE_ALL_NGEN_IMAGES` estiverem especificados, `COR_PRF_DISABLE_ALL_NGEN_IMAGES` será usado.

Sinalizadores compostos

Membro	DESCRIÇÃO
`COR_PRF_ALL`	Representa todos os valores de sinalizador `COR_PRF_MONITOR`.
`COR_PRF_ALLOWABLE_AFTER_ATTACH`	Representa todos os sinalizadores `COR_PRF_MONITOR` que podem ser definidos após o criador de perfis ser anexado a um aplicativo em execução. A seção de sintaxe indica os sinalizadores individuais que estão presentes nesta bitmask.
`COR_PRF_MONITOR_ALL`	Habilita todos os eventos de retorno de chamada.
`COR_PRF_MONITOR_IMMUTABLE`	Representa todos os sinalizadores `COR_PRF_MONITOR` que podem ser definidos apenas durante a inicialização. A tentativa de alterar qualquer um desses sinalizadores após a inicialização retorna um valor `HRESULT` que indica falha.
`COR_PRF_REQUIRE_PROFILE_IMAGE`	Representa todos os sinalizadores `COR_PRF_MONITOR` que necessitam de imagens aprimoradas por perfil.

Comentários

Um valor COR_PRF_MONITOR é usado com os métodos ICorProfilerInfo::GetEventMask e ICorProfilerInfo::SetEventMask para definir as notificações de eventos que o Common Language Runtime faz no criador de perfil.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponíveis desde a versão 1.0

Compartilhar via