Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. O ICorProfilerCallback2 interface é uma extensão de ICorProfilerCallback interface. Ou seja, ele fornece novos retornos de chamada introduzidos na.NET Framework versão 2.0.
Observação
Cada implementação do método deve retornar um HRESULT que tiver o valor S_OK no sucesso ou E_FAIL em caso de falha.Atualmente, o CLR ignora o HRESULT retornado por cada retorno de chamada, exceto ICorProfilerCallback::ObjectReferences.
Métodos
Método |
Descrição |
|---|---|
Notifica o criador de perfil de código para que um objeto com um finalizador foi enfileirado a thread do finalizador para execução do seu Finalize método. |
|
Notifica o criador de perfil que concluiu a coleta de lixo e todos os retornos de chamada de coleta de lixo foram emitidos por ela. |
|
Notifica o criador de perfil de código que começou uma coleta de lixo. |
|
Notifica o criador de perfil de código que foi criada uma alça de coleta de lixo. |
|
Notifica o criador de perfil de código para uma alça de coleta de lixo foi destruída. |
|
Notifica o profiler sobre referências de raiz após a ocorrência de uma coleta de lixo. Esse método é uma extensão de ICorProfilerCallback::RootReferences método. |
|
Notifica o profiler sobre referências de objeto que sobreviveram a uma coleta de lixo. |
|
Notifica o criador de perfil de código que mudou o nome de um thread. |
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 tinha 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 2.0 e versões posteriores, o criador de perfil também deve implementar a ICorProfilerCallback2 métodos. Cada implementação do método deve retornar um HRESULT que tiver o valor S_OK no sucesso ou E_FAIL em caso de falha. Atualmente, o CLR ignora o HRESULT retornado por cada retorno de chamada, exceto ICorProfilerCallback::ObjectReferences.
Um gerador de perfil de código deve se registrar no registro do Microsoft Windows, seu objeto 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 profiler é alvo.NET Framework versão 1.0 ou 1.1, esse objeto COM precisa implementar apenas os métodos de ICorProfilerCallback.Se ele está direcionado.NET Framework versão 2.0 e posteriores, 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
Consulte também
Referência
Interface de ICorProfilerCallback