Compartilhar via

Interface ICorProfilerCallback2

  • Artigo

Fornece métodos usados pelo Common Language Runtime (CLR) para notificar um criador de perfis de código quando ocorrerem os eventos assinados pelo criador de perfis. A interface ICorProfilerCallback2 é uma extensão da ICorProfilerCallback. Ou seja, ele fornece novos retornos de chamada introduzidos no .NET Framework versão 2.0.

Observação

Cada implementação de método deve retornar um HRESULT com o valor S_OK em caso de êxito, 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
Método FinalizeableObjectQueued Notifica o criador de perfil de código que um objeto com um finalizador foi enfileirado no thread do finalizador para execução de seu método Finalize.
Método GarbageCollectionFinished Notifica o criador de perfil de que uma coleta de lixo foi concluída e todos os retornos de chamada de coleta de lixo foram emitidos para ele.
Método GarbageCollectionStarted Notifica o criador de perfil de código que uma coleta de lixo foi iniciada.
Método HandleCreated Notifica o criador de perfil de código de que um identificador de coleta de lixo foi criado.
Método HandleDestroyed Notifica o criador de perfil de código de que um identificador de coleta de lixo foi destruído.
Método RootReferences2 Notifica o criador de perfil sobre referências raiz após a coleta de lixo. Esse método é uma extensão do método ICorProfilerCallback::RootReferences.
Método SurvivingReferences Notifica o criador de perfil sobre referências de objeto que sobreviveram a uma coleta de lixo.
Método ThreadNameChanged Notifica o criador de perfil de código de que o nome de um thread foi alterado.

Comentários

O CLR chama um método na interface ICorProfilerCallback (ou ICorProfilerCallback2) para notificar o criador de perfil quando ocorre um evento em que o criador de perfil se inscreveu. Essa é a interface de retorno de chamada principal 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 interface ICorProfilerCallback. Para o .NET Framework 2.0 e versões posteriores, o criador de perfil também deve implementar os métodos ICorProfilerCallback2. Cada implementação de método deve retornar um HRESULT com o valor S_OK em caso de êxito, ou E_FAIL em caso de falha. Atualmente, o CLR ignora o HRESULT retornado por cada retorno de chamada, exceto ICorProfilerCallback::ObjectReferences.

Um criador de perfil de código deve registrar no Registro do Microsoft Windows o objeto COM que implementa as interfaces ICorProfilerCallback e ICorProfilerCallback2. 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. Depois disso, o criador de perfil poderá receber uma notificação do runtime quando um evento estiver prestes a ocorrer ou quando tiver ocorrido apenas em um processo de runtime em execução.

Observação

O criador de perfil registra apenas um objeto COM. Se o criador de perfil adotar como destino o .NET Framework versão 1.0 ou 1.1, esse objeto COM só precisará implementar os métodos de ICorProfilerCallback. Se o foco do criador de perfil for o .NET Framework 2.0 ou versões posteriores, o objeto COM também precisará implementar os métodos de ICorProfilerCallback2.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 2.0

Confira também