Partilhar via

ICorProfilerInfo Interface

  • Artigo

Fornece métodos para uso por criadores de perfil de código para se comunicar com o Common Language Runtime (CLR) para controlar o monitoramento de eventos e solicitar informações.

Nota

Cada método na ICorProfilerInfo interface retorna um HRESULT para indicar sucesso ou falha. Consulte CorError.h para obter uma lista de possíveis códigos de retorno.

Métodos

Método Description
Método BeginInprocDebugging Inicializa o suporte à depuração em processo. Esse método é obsoleto no .NET Framework versão 2.0.
Método EndInprocDebugging Desliga uma sessão de depuração em processo. Esse método é obsoleto no .NET Framework versão 2.0.
Método ForceGC Força a coleta de lixo a ocorrer dentro do tempo de execução.
Método GetAppDomainInfo Obtém informações sobre o domínio do aplicativo especificado.
Método GetAssemblyInfo Obtém informações sobre o assembly especificado.
Método GetClassFromObject Obtém o ClassID de um

objeto, dado o seu ObjectID.
Método GetClassFromToken Obtém a ID da classe, dado o token de metadados. Esse método é obsoleto no .NET Framework versão 2.0. Use o ICorProfilerInfo2::GetClassFromTokenAndTypeArgs método em vez disso.
Método GetClassIDInfo Obtém o módulo pai e o token de metadados para a classe especificada.
Método GetCodeInfo Obtém a extensão do código nativo associado ao ID da função especificada. Este método está obsoleto. Use o ICorProfilerInfo2::GetCodeInfo2 método em vez disso.
Método GetCurrentThreadID Obtém a ID do thread atual, se for um thread gerenciado.
Método GetEventMask Obtém as categorias de eventos atuais para as quais o criador de perfil deseja receber notificações de eventos do CLR.
Método GetFunctionFromIP Mapeia um ponteiro de instrução de código gerenciado para um FunctionIDarquivo .
Método GetFunctionFromToken Obtém a ID de uma função. Esse método é obsoleto no .NET Framework versão 2.0. Use o ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs método em vez disso.
Método GetFunctionInfo Obtém a classe pai e o token de metadados para a função especificada.
Método GetHandleFromThread Mapeia a ID de um thread para um identificador de thread Win32.
Método GetILFunctionBody Obtém um ponteiro para o corpo de um método em código de linguagem intermediária comum (CIL), começando em seu cabeçalho.
Método GetILFunctionBodyAllocator Obtém uma interface que fornece um método para alocar memória a ser usada para trocar o corpo de um método no código CIL.
Método GetILToNativeMapping Obtém um mapa de deslocamentos CIL para deslocamentos nativos para o código contido na função especificada.
Método GetInprocInspectionInterface Obtém um objeto que pode ser consultado para uma interface ICorDebugProcess. Esse método é obsoleto no .NET Framework versão 2.0.
Método GetInprocInspectionIThisThread Obtém um objeto que pode ser consultado para o ICorDebugThread interface. Esse método é obsoleto no .NET Framework versão 2.0.
Método GetModuleInfo Dado um ID de módulo, retorna o nome do arquivo do módulo e o ID do assembly pai do módulo.
Método GetModuleMetaData Obtém uma instância de interface de metadados que mapeia para o módulo especificado.
Método GetObjectSize Obtém o tamanho de um objeto especificado.
Método GetThreadContext Obtém a identidade de contexto atualmente associada ao thread especificado.
Método GetThreadInfo Obtém a identidade de thread Win32 atual para o thread especificado.
Método GetTokenAndMetadataFromFunction Obtém o token de metadados e uma instância da interface de metadados que pode ser usada no token para a função especificada.
Método IsArrayClass Determina se a classe especificada é uma classe de matriz.
Método SetEnterLeaveFunctionHooks Especifica as funções implementadas pelo profiler a serem chamadas nos ganchos "enter", "leave" e "tailcall" das funções gerenciadas.
Método SetEventMask Define um valor que especifica os tipos de eventos para os quais o criador de perfil deseja receber notificação do CLR.
Método SetFunctionIDMapper Especifica a função implementada pelo profiler que será chamada para mapear FunctionID valores para valores alternativos, que são passados para os ganchos de entrada/saída da função do profiler.
Método SetFunctionReJIT Não implementado. Não utilizar.
Método SetILFunctionBody Substitui o corpo da função especificada no módulo especificado.
Método SetILInstrumentedCodeMap Especifica como os deslocamentos da CIL original de uma função especificada são mapeados para os novos deslocamentos da CIL modificada pelo profiler da função.

Observações

Um criador de perfil chama um método na ICorProfilerInfo interface para se comunicar com o CLR para controlar o monitoramento de eventos e solicitar informações.

Os métodos da ICorProfilerInfo interface são implementados pelo CLR usando o modelo free-threaded. Cada método retorna um HRESULT para indicar sucesso ou falha. Consulte CorError.h para obter uma lista de possíveis códigos de retorno.

O CLR passa, através da implementação do criador de perfil de ICorProfilerCallback::Initialize, uma ICorProfilerInfo interface para cada criador de perfil de código durante a inicialização. Um criador de perfil de código pode então chamar métodos da interface para obter informações sobre o ICorProfilerInfo código gerenciado que está sendo executado sob o controle do CLR.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponível desde 2.0

Consulte também