Interface de ICorProfilerCallback2
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