Compartilhar via

ICorProfilerCallback Interface

Fornece métodos usados pelo CLR (Common Language Runtime) para notificar um criador de perfil de código quando ocorrerem os eventos aos quais o criador de perfil se inscreveu.

Methods

Método Description
Método AppDomainCreationFinished Notifica o criador de perfil de que um domínio de aplicativo foi criado.
Método AppDomainCreationStarted Notifica o criador de perfil de que um domínio de aplicativo está sendo criado.
Método AppDomainShutdownFinished Notifica o criador de perfil de que um domínio de aplicativo foi descarregado de um processo.
Método AppDomainShutdownStarted Notifica o criador de perfil de que um domínio de aplicativo está sendo descarregado de um processo.
Método AssemblyLoadFinished Notifica o criador de perfil de que um assembly terminou de carregar.
Método AssemblyLoadStarted Notifica o criador de perfil de que um assembly está sendo carregado.
Método AssemblyUnloadFinished Notifica o criador de perfil de que um assembly foi descarregado.
Método AssemblyUnloadStarted Notifica o criador de perfil de que um assembly está sendo descarregado.
Método ClassLoadFinished Notifica o criador de perfil de que uma classe terminou de carregar.
Método ClassLoadStarted Notifica o criador de perfil de que uma classe está sendo carregada.
Método ClassUnloadFinished Notifica o criador de perfil de que uma classe terminou de descarregar.
Método ClassUnloadStarted Notifica o criador de perfil de que uma classe está sendo descarregada.
Método COMClassicVTableCreated Notifica o criador de perfil de que um wrapper callable de runtime (RCW) para o IID e a classe especificados foi criado.
Método COMClassicVTableDestroyed Notifica o criador de perfil de que um RCW está sendo destruído.
Método ExceptionCatcherEnter Notifica o criador de perfil de que o controle está sendo passado para o bloco apropriado catch .
Método ExceptionCatcherLeave Notifica o criador de perfil de que o controle está sendo passado para fora do bloco apropriado catch .
Método ExceptionCLRCatcherExecute Obsoleto no .NET Framework versão 2.0.
Método ExceptionCLRCatcherFound Obsoleto no .NET Framework 2.0.
Método ExceptionOSHandlerEnter Não implementado. Um criador de perfil que precisa de informações de exceção não gerenciadas deve obter essas informações por meio de outros meios.
Método ExceptionOSHandlerLeave Não implementado. Um criador de perfil que precisa de informações de exceção não gerenciadas deve obter essas informações por meio de outros meios.
Método ExceptionSearchCatcherFound Notifica o criador de perfil de que a fase de pesquisa do tratamento de exceções localizou um manipulador para a exceção que foi gerada.
Método ExceptionSearchFilterEnter Notifica o criador de perfil de que um filtro de usuário está sendo executado.
Método ExceptionSearchFilterLeave Notifica o criador de perfil de que um filtro de usuário acabou de ser executado.
Método ExceptionSearchFunctionEnter Notifica o criador de perfil de que a fase de pesquisa do tratamento de exceções inseriu uma função.
Método ExceptionSearchFunctionLeave Notifica o criador de perfil de que a fase de pesquisa do tratamento de exceções terminou de pesquisar uma função.
Método ExceptionThrown Notifica o criador de perfil de que uma exceção foi gerada.
Método ExceptionUnwindFinallyEnter Notifica o criador de perfil de que a fase de desenrolamento do tratamento de exceções está inserindo uma finally cláusula contida na função especificada.
Método ExceptionUnwindFinallyLeave Notifica o criador de perfil de que a fase de desenrolamento do tratamento de exceções deixou uma finally cláusula.
Método ExceptionUnwindFunctionEnter Notifica o criador de perfil de que a fase de desenrolamento do tratamento de exceções inseriu uma função.
Método ExceptionUnwindFunctionLeave Notifica o criador de perfil de que a fase de desenrolamento do tratamento de exceções terminou de descontrair uma função.
Método FunctionUnloadStarted Notifica o criador de perfil de que o runtime começou a descarregar uma função.
Método Initialize Chamado para inicializar o criador de perfil sempre que um novo aplicativo CLR for iniciado.
Método JITCachedFunctionSearchFinished Notifica o criador de perfil de que uma pesquisa concluiu uma função que foi compilada anteriormente usando NGen.exe.
Método JITCachedFunctionSearchStarted Notifica o criador de perfil de que uma pesquisa foi iniciada para uma função que foi compilada anteriormente usando NGen.exe.
Método JITCompilationFinished Notifica o criador de perfil de que o compilador JIT terminou de compilar uma função.
Método JITCompilationStarted Notifica o criador de perfil de que o compilador just-in-time (JIT) começou a compilar uma função.
Método JITFunctionPitched Notifica o criador de perfil de que uma função que foi compilada por JIT foi removida da memória.
Método JITInlining Notifica o criador de perfil de que o compilador JIT está prestes a inserir uma função de acordo com outra função.
Método ManagedToUnmanagedTransition Notifica o criador de perfil de que ocorreu uma transição do código gerenciado para o código não gerenciado.
Método ModuleAttachedToAssembly Notifica o criador de perfil de que um módulo está sendo anexado ao assembly pai.
Método ModuleLoadFinished Notifica o criador de perfil de que um módulo terminou de carregar.
Método ModuleLoadStarted Notifica o criador de perfil de que um módulo está sendo carregado.
Método ModuleUnloadFinished Notifica o criador de perfil de que um módulo terminou de descarregar.
Método ModuleUnloadStarted Notifica o criador de perfil de que um módulo está sendo descarregado.
Método MovedReferences Notifica o criador de perfil sobre referências de objeto que foram movidas durante a coleta de lixo.
Método ObjectAllocated Notifica o criador de perfil de que a memória dentro do heap foi alocada para um objeto.
Método ObjectReferences Notifica o criador de perfil sobre objetos na memória referenciados pelo objeto especificado.
Método ObjectsAllocatedByClass Notifica o criador de perfil sobre o número de instâncias de cada classe especificada que foram criadas desde a coleta de lixo anterior.
Método RemotingClientInvocationFinished Notifica o criador de perfil de que uma chamada de comunicação remota foi executada até a conclusão no cliente.
Método RemotingClientInvocationStarted Notifica o criador de perfil de que uma chamada de comunicação remota foi iniciada.
Método RemotingClientReceivingReply Notifica o criador de perfil de que a parte do lado do servidor de uma chamada de comunicação remota foi concluída e o cliente agora está recebendo e prestes a processar a resposta.
Método RemotingClientSendingMessage Notifica o criador de perfil de que o cliente está enviando uma solicitação para o servidor.
Método RemotingServerInvocationReturned Notifica o criador de perfil de que o processo terminou de invocar um método em resposta a uma solicitação de invocação de método remoto.
Método RemotingServerInvocationStarted Notifica o criador de perfil de que o processo está invocando um método em resposta a uma solicitação de invocação de método remoto.
Método RemotingServerReceivingMessage Notifica o criador de perfil de que o processo está recebendo uma solicitação de invocação ou ativação de método remoto.
Método RemotingServerSendingReply Notifica o criador de perfil de que o processo terminou de processar uma solicitação de invocação de método remoto e está prestes a transmitir a resposta por meio de um canal.
Método RootReferences Notifica o criador de perfil com informações sobre referências raiz após a coleta de lixo.
Método RuntimeResumeFinished Notifica o criador de perfil de que o runtime retomou todos os threads de runtime e voltou à operação normal.
Método RuntimeResumeStarted Notifica o criador de perfil de que o runtime está retomando todos os threads de runtime.
Método RuntimeSuspendAborted Notifica o criador de perfil de que o runtime anulou a suspensão de runtime que estava ocorrendo.
Método RuntimeSuspendFinished Notifica o criador de perfil de que o runtime concluiu a suspensão de todos os threads de runtime.
Método RuntimeSuspendStarted Notifica o criador de perfil de que o runtime está prestes a suspender todos os threads de runtime.
Método RuntimeThreadResumed Notifica o criador de perfil de que o thread especificado foi retomado após ser suspenso.
Método RuntimeThreadSuspended Notifica o criador de perfil de que o thread especificado foi ou está prestes a ser suspenso.
Método shutdown Notifica o criador de perfil de que o aplicativo está sendo desligado.
Método ThreadAssignedToOSThread Notifica o criador de perfil de que um thread gerenciado está sendo implementado usando um thread específico do sistema operacional (SO).
Método ThreadCreated Notifica o criador de perfil de que um thread foi criado.
Método ThreadDestroyed Notifica o criador de perfil de que um thread foi destruído.
Método UnmanagedToManagedTransition Notifica o criador de perfil de que ocorreu uma transição do código não gerenciado para o código gerenciado.

Observações

O CLR chama um método na ICorProfilerCallback interface (ou ICorProfilerCallback2) para notificar o criador de perfil quando um evento, ao qual o criador de perfil se inscreveu, ocorrer. Essa é a interface de retorno de chamada primária por meio da qual o CLR se comunica com o criador de perfil de código.

Um criador de perfil de código deve implementar os métodos da ICorProfilerCallback interface. Para o .NET Framework versão 2.0 ou posterior, o criador de perfil também deve implementar os ICorProfilerCallback2 métodos. Cada implementação de método deve retornar um HRESULT que tenha um valor de S_OK em êxito ou E_FAIL em caso de falha. Atualmente, o CLR ignora o HRESULT retornado por cada retorno de chamada, exceto ICorProfilerCallback::ObjectReferences.

No registro do Microsoft Windows, um criador de perfil de código deve registrar seu objeto COM (Component Object Model) que implementa as interfaces e ICorProfilerCallback2 as ICorProfilerCallback interfaces. Um criador de perfil de código assina os eventos para os quais deseja receber notificação chamando ICorProfilerInfo::SetEventMask. Isso geralmente é feito na implementação do criador de perfil de ICorProfilerCallback::Initialize. Em seguida, o criador de perfil pode receber uma notificação do runtime quando um evento está prestes a ocorrer ou ocorreu em um processo de runtime em execução.

Observação

O criador de perfil registra um único objeto COM. Se o criador de perfil estiver direcionando o .NET Framework versão 1.0 ou 1.1, esse objeto COM precisará implementar apenas os métodos de ICorProfilerCallback. Se estiver direcionando o .NET Framework versão 2.0 ou posterior, o objeto COM também deverá implementar os métodos de ICorProfilerCallback2.

Requirements

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

Consulte também

  • Last updated on