Interface de ICorProfilerCallback

Fornece métodos que são usados pelo common language runtime (CLR) para notificar um gerador de perfil de código quando ocorrem os eventos aos quais o profiler se associou.

Métodos

Método	Descrição
Método de ICorProfilerCallback::AppDomainCreationFinished	Notifica o criador de perfil que foi criado um domínio de aplicativo.
Método de ICorProfilerCallback::AppDomainCreationStarted	Notifica o profiler para que um domínio de aplicativo está sendo criado.
Método de ICorProfilerCallback::AppDomainShutdownFinished	Notifica o criador de perfil de um domínio de aplicativo tenha sido descarregado a partir de um processo.
Método de ICorProfilerCallback::AppDomainShutdownStarted	Notifica o profiler para que um domínio de aplicativo está sendo descarregado a partir de um processo.
Método de ICorProfilerCallback::AssemblyLoadFinished	Notifica o criador de perfil que um assembly foi carregado.
Método de ICorProfilerCallback::AssemblyLoadStarted	Notifica o criador de perfil que um assembly está sendo carregado.
Método de ICorProfilerCallback::AssemblyUnloadFinished	Notifica o criador de perfil de um assembly ter sido descarregado.
Método de ICorProfilerCallback::AssemblyUnloadStarted	Notifica o criador de perfil que um assembly está sendo descarregado.
Método de ICorProfilerCallback::ClassLoadFinished	Notifica o criador de perfil que uma classe foi carregado.
Método de ICorProfilerCallback::ClassLoadStarted	Notifica o criador de perfil que uma classe está sendo carregada.
Método de ICorProfilerCallback::ClassUnloadFinished	Notifica o criador de perfil que uma classe terminou de descarregamento.
Método de ICorProfilerCallback::ClassUnloadStarted	Notifica o criador de perfil que uma classe está sendo descarregada.
Método de ICorProfilerCallback::COMClassicVTableCreated	Notifica o criador de perfil que foi criado um runtime callable wrapper (RCW) para a IID e a classe especificada.
Método de ICorProfilerCallback::COMClassicVTableDestroyed	Notifica o criador de perfil que um RCW está sendo destruído.
Método de ICorProfilerCallback::ExceptionCatcherEnter	Notifica o criador de perfil que o controle está sendo passado para o apropriado catch bloco.
Método de ICorProfilerCallback::ExceptionCatcherLeave	Notifica o criador de perfil que está sendo passado o controle fora do catch bloco.
Método de ICorProfilerCallback::ExceptionCLRCatcherExecute	Obsoleta na.NET Framework versão 2.0.
Método de ICorProfilerCallback::ExceptionCLRCatcherFound	Obsoleta na.NET Framework 2.0.
Método de ICorProfilerCallback::ExceptionOSHandlerEnter	Não implementado. Um gerador de perfil que precisa de informações de exceção não gerenciado deve obter essas informações por outros meios.
Método de ICorProfilerCallback::ExceptionOSHandlerLeave	Não implementado. Um gerador de perfil que precisa de informações de exceção não gerenciado deve obter essas informações por outros meios.
Método de ICorProfilerCallback::ExceptionSearchCatcherFound	Notifica o criador de perfil que a fase de pesquisa de manipulação de exceção foi localizado um manipulador para a exceção foi acionada.
Método de ICorProfilerCallback::ExceptionSearchFilterEnter	Notifica o criador de perfil que um filtro de usuário está sendo executado.
Método de ICorProfilerCallback::ExceptionSearchFilterLeave	Notifica o criador de perfil que um filtro de usuário acaba de ser executado.
Método de ICorProfilerCallback::ExceptionSearchFunctionEnter	Notifica o criador de perfil que a fase de pesquisa de manipulação de exceção inseriu uma função.
Método de ICorProfilerCallback::ExceptionSearchFunctionLeave	Notifica o criador de perfil que a fase de pesquisa de manipulação de exceção concluiu a pesquisa a uma função.
Método de ICorProfilerCallback::ExceptionThrown	Notifica o profiler uma exceção foi acionada.
Método de ICorProfilerCallback::ExceptionUnwindFinallyEnter	Notifica o criador de perfil da fase de desenrolamento da exceção está entrando no tratamento de um finally cláusula contida na função especificada.
Método de ICorProfilerCallback::ExceptionUnwindFinallyLeave	Notifica o criador de perfil da fase de desenrolamento da exceção tratamento deixou um finally cláusula.
Método de ICorProfilerCallback::ExceptionUnwindFunctionEnter	Notifica o criador de perfil que a fase de desenrolamento da manipulação de exceção inseriu uma função.
Método de ICorProfilerCallback::ExceptionUnwindFunctionLeave	Notifica o criador de perfil que a fase de desenrolamento da manipulação de exceção concluiu desenrolar a uma função.
Método de ICorProfilerCallback::FunctionUnloadStarted	Notifica o profiler para que o runtime foi iniciado para descarregar uma função.
Método de ICorProfilerCallback::Initialize	Chamado para inicializar o gerador de perfil sempre que um novo aplicativo do CLR é iniciado.
Método de ICorProfilerCallback::JITCachedFunctionSearchFinished	Notifica o criador de perfil que uma pesquisa foi finalizada por uma função que foi compilada usando o NGen. exe anteriormente.
Método de ICorProfilerCallback::JITCachedFunctionSearchStarted	Notifica o criador de perfil que uma pesquisa foi iniciado por uma função que foi compilada usando o NGen. exe anteriormente.
Método de ICorProfilerCallback::JITCompilationFinished	Notifica o profiler para que o compilador JIT concluiu a compilação de uma função.
Método de ICorProfilerCallback::JITCompilationStarted	Notifica o profiler para que o compilador just-in-time (JIT) foi iniciado para compilar uma função.
Método de ICorProfilerCallback::JITFunctionPitched	Notifica o criador de perfil que uma função que foi compilado em JIT foi removida da memória.
Método de ICorProfilerCallback::JITInlining	Notifica o profiler para que o compilador JIT está prestes a inserir uma função de acordo com a outra função.
Método de ICorProfilerCallback::ManagedToUnmanagedTransition	Notifica o criador de perfil que ocorreu uma transição de código gerenciado para código não gerenciado.
Método de ICorProfilerCallback::ModuleAttachedToAssembly	Notifica o criador de perfil que está sendo anexado a um módulo para seu assembly pai.
Método de ICorProfilerCallback::ModuleLoadFinished	Notifica o criador de perfil que um módulo foi carregado.
Método de ICorProfilerCallback::ModuleLoadStarted	Notifica o criador de perfil que um módulo está sendo carregado.
Método de ICorProfilerCallback::ModuleUnloadFinished	Notifica o criador de perfil que um módulo terminou de descarregamento.
Método de ICorProfilerCallback::ModuleUnloadStarted	Notifica o criador de perfil que um módulo está sendo descarregado.
Método de ICorProfilerCallback::MovedReferences	Notifica o profiler sobre referências de objeto que foram movidos durante a coleta de lixo.
Método de ICorProfilerCallback::ObjectAllocated	Notifica o criador de perfil que memória dentro do heap foi alocada para um objeto.
Método de ICorProfilerCallback::ObjectReferences	Notifica o profiler sobre objetos em memória referenciada pelo objeto especificado.
Método de ICorProfilerCallback::ObjectsAllocatedByClass	Notifica o criador de perfil sobre o número de instâncias de cada classe especificada que foram criados desde a coleta de lixo anterior.
Método de ICorProfilerCallback::RemotingClientInvocationFinished	Notifica o profiler se uma chamada de remoting foi executada para conclusão no cliente.
Método de ICorProfilerCallback::RemotingClientInvocationStarted	Notifica o criador de perfil que uma chamada de remoting foi iniciado.
Método de ICorProfilerCallback::RemotingClientReceivingReply	Notifica o criador de perfil que a parte do lado do servidor de uma chamada de remoting foi concluída e o cliente agora está recebendo e prestes a processar a resposta.
Método de ICorProfilerCallback::RemotingClientSendingMessage	Notifica o profiler para que o cliente está enviando uma solicitação ao servidor.
Método de ICorProfilerCallback::RemotingServerInvocationReturned	Notifica o profiler para que o processo terminar invocando um método em resposta a uma solicitação de invocação de método remoto.
Método de ICorProfilerCallback::RemotingServerInvocationStarted	Notifica o profiler para que o processo está chamando um método em resposta a uma solicitação de invocação de método remoto.
Método de ICorProfilerCallback::RemotingServerReceivingMessage	Notifica o profiler para que o processo está recebendo uma solicitação de ativação ou de invocação de método remoto.
Método de ICorProfilerCallback::RemotingServerSendingReply	Notifica o criador de perfil que o processo terminou de processar uma solicitação de invocação de método remoto e é a resposta por meio de um canal de transmissão.
Método de ICorProfilerCallback::RootReferences	Notifica o profiler com informações sobre referências raiz após a coleta de lixo.
Método de ICorProfilerCallback::RuntimeResumeFinished	Notifica o criador de perfil que o runtime reiniciou a todos os threads de runtime e retornou à operação normal.
Método de ICorProfilerCallback::RuntimeResumeStarted	Notifica o profiler para que o tempo de execução está continuando a todos os threads de tempo de execução.
Método de ICorProfilerCallback::RuntimeSuspendAborted	Notifica o profiler para que o runtime foi anulada a suspensão de tempo de execução estava ocorrendo.
Método de ICorProfilerCallback::RuntimeSuspendFinished	Notifica o profiler para que o runtime concluiu a suspensão de todos os threads de tempo de execução.
Método de ICorProfilerCallback::RuntimeSuspendStarted	Notifica o profiler para que o tempo de execução está prestes a suspender todos os segmentos de tempo de execução.
Método de ICorProfilerCallback::RuntimeThreadResumed	Notifica o profiler para que o segmento especificado foi retomado após sendo suspenso.
Método de ICorProfilerCallback::RuntimeThreadSuspended	Notifica o criador de perfil que o segmento especificado foi ou está prestes a ser, suspenso.
Método de ICorProfilerCallback::Shutdown	Notifica o profiler para que o aplicativo está sendo desligado.
Método de ICorProfilerCallback::ThreadAssignedToOSThread	Notifica o criador de perfil que um segmento gerenciado está sendo implementado usando um thread do sistema operacional em particular (SO).
Método de ICorProfilerCallback::ThreadCreated	Notifica o criador de perfil que um segmento foi criado.
Método de ICorProfilerCallback::ThreadDestroyed	Notifica o criador de perfil de um segmento foi destruído.
Método de ICorProfilerCallback::UnmanagedToManagedTransition	Notifica o criador de perfil que ocorreu uma transição de código não gerenciado para código gerenciado.

Comentários

O CLR chama um método de ICorProfilerCallback (ou ICorProfilerCallback2) interface para notificar o criador de perfil quando um evento, para que o profiler está inscrito, ocorre. Esta é a interface primária de retorno de chamada por meio do qual o CLR se comunica com o criador de perfil de código.

Um gerador de perfil de código deve implementar os métodos de ICorProfilerCallback interface. Para o.NET Framework versão 2.0 ou posterior, o criador de perfil também deve implementar a ICorProfilerCallback2 métodos. Cada implementação do método deve retornar um HRESULT que tem um valor de S_OK sucesso 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 gerador de perfil de código deve registrar seu objeto de modelo de objeto componente (COM) que implementa o ICorProfilerCallback e ICorProfilerCallback2 interfaces. Um gerador de perfil de código assina os eventos para o qual deseja receber notificação chamando ICorProfilerInfo::SetEventMask. Normalmente, isso é feito na implementação do criador de perfil do ICorProfilerCallback::Initialize. O profiler é capaz de receber uma notificação do tempo de execução quando um evento está prestes a ocorrer ou apenas ocorreu em um processo em execução do tempo de execução.

Observação

O profiler registra um único objeto COM.Se o criador de perfil está voltada a.NET Framework versão 1.0 ou 1.1, que o objeto COM precisa implementar apenas os métodos de ICorProfilerCallback.Se ele está direcionado.NET Framework versão 2.0 ou posterior, o objeto COM também deve implementar os métodos de ICorProfilerCallback2.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: Corprof. idl, CorProf.h

Biblioteca: CorGuids.lib

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Consulte também

Referência

Interface de ICorProfilerCallback2

Outros recursos

Interfaces de criação de perfil