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