Interface de ICorProfilerInfo

Fornece métodos para uso por criadores de perfis de código para se comunicar com o common language runtime (CLR) para controlar a monitoração de eventos e solicitar informações.

Observação

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

Métodos

Método	Descrição
Método de ICorProfilerInfo::BeginInprocDebugging	Inicializa em processo suporte à depuração. Este método está obsoleto na.NET Framework versão 2.0.
Método de ICorProfilerInfo::EndInprocDebugging	Encerra uma sessão de depuração no processo. Este método está obsoleto na.NET Framework versão 2.0.
Método de ICorProfilerInfo::ForceGC	Coleta de lixo forças ocorra dentro do runtime.
Método de ICorProfilerInfo::GetAppDomainInfo	Obtém informações sobre o domínio de aplicativo especificado.
Método de ICorProfilerInfo::GetAssemblyInfo	Obtém informações sobre o assembly especificado.
Método de ICorProfilerInfo::GetClassFromObject	Obtém o ClassID de um o objeto, dado sua ObjectID.
Método de ICorProfilerInfo::GetClassFromToken	Obtém a ID da classe, dado o token de metadados. Este método está obsoleto na.NET Framework versão 2.0. Use o ICorProfilerInfo2::GetClassFromTokenAndTypeArgs método em vez disso.
Método de ICorProfilerInfo::GetClassIDInfo	Obtém o pai de módulo e o token de metadados para a classe especificada.
Método de ICorProfilerInfo::GetCodeInfo	Obtém a extensão de código nativo associado com a identificação da função especificada. Este método está obsoleto. Use o ICorProfilerInfo2::GetCodeInfo2 método em vez disso.
Método de ICorProfilerInfo::GetCurrentThreadID	Obtém a identificação do segmento atual, se for um segmento gerenciado.
Método de ICorProfilerInfo::GetEventMask	Obtém as categorias de eventos atual para o qual deseja receber notificações de eventos do CLR profiler.
Método de ICorProfilerInfo::GetFunctionFromIP	Mapeia um ponteiro de instrução do código gerenciado para um FunctionID.
Método de ICorProfilerInfo::GetFunctionFromToken	Obtém a ID de uma função. Este método está obsoleto na.NET Framework versão 2.0. Use o ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs método em vez disso.
Método de ICorProfilerInfo::GetFunctionInfo	Obtém a classe pai e os metadados de token para a função especificada.
Método de ICorProfilerInfo::GetHandleFromThread	Mapeie a identificação de um thread para um identificador de segmento do Win32.
Método de ICorProfilerInfo::GetILFunctionBody	Obtém um ponteiro para o corpo de um método no código do Microsoft intermediate language (MSIL), começando em seu cabeçalho.
Método de ICorProfilerInfo::GetILFunctionBodyAllocator	Obtém uma interface que fornece um método para alocar memória para ser usado para trocar o corpo de um método no código MSIL.
Método de ICorProfilerInfo::GetILToNativeMapping	Obtém um mapa de MSIL deslocamentos para deslocamentos nativos para o código contido na função especificada.
Método de ICorProfilerInfo::GetInprocInspectionInterface	Obtém um objeto que pode ser consultado para um ICorDebugProcess interface. Este método está obsoleto na.NET Framework versão 2.0.
Método de ICorProfilerInfo::GetInprocInspectionIThisThread	Obtém um objeto que pode ser consultado para a ICorDebugThread interface. Este método está obsoleto na.NET Framework versão 2.0.
Método de ICorProfilerInfo::GetModuleInfo	Dada uma identificação de módulo, retorna o nome do arquivo do módulo e a identificação do assembly do pai do módulo.
Método de ICorProfilerInfo::GetModuleMetaData	Obtém uma instância de interface de metadados que mapeia para o módulo especificado.
Método de ICorProfilerInfo::GetObjectSize	Obtém o tamanho de um objeto especificado.
Método de ICorProfilerInfo::GetThreadContext	Obtém a identidade de contexto associada ao segmento especificado no momento.
Método de ICorProfilerInfo::GetThreadInfo	Obtém a identidade atual do thread do Win32 para o segmento especificado.
Método de ICorProfilerInfo::GetTokenAndMetadataFromFunction	Obtém o token de metadados e uma instância da interface de metadados que pode ser usada contra o símbolo da função especificada.
Método de ICorProfilerInfo::IsArrayClass	Determina se a classe especificada é uma classe de matriz.
Método de ICorProfilerInfo::SetEnterLeaveFunctionHooks	Especifica o profiler implementado funções ser chamado em "enter", "deixe" e "tailcall" Ganchos de funções gerenciadas.
Método de ICorProfilerInfo::SetEventMask	Define um valor que especifica os tipos de eventos para o qual deseja receber notificação do CLR profiler.
Método de ICorProfilerInfo::SetFunctionIDMapper	Especifica a função implementado o profiler que será chamada para mapear FunctionID valores para valores alternativos, que são passados para o profiler função entrada/saída ganchos.
Método de ICorProfilerInfo::SetFunctionReJIT	Não implementado. Não use.
Método de ICorProfilerInfo::SetILFunctionBody	Substitui o corpo da função especificada no módulo especificado.
Método de ICorProfilerInfo::SetILInstrumentedCodeMap	Especifica como mapeiam os deslocamentos de MSIL original de uma função específica novos deslocamentos de MSIL de modificação do profiler da função.

Comentários

Um gerador de perfil chama um método de ICorProfilerInfo interface para se comunicar com o CLR para controlar a monitoração de eventos e informações de solicitação.

Os métodos de ICorProfilerInfo interface são implementados pelo CLR usando o modelo de segmentação livre. Cada método retorna um HRESULT para indicar sucesso ou falha. Consulte CORERROR para obter uma lista de possíveis códigos de retorno.

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

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 ICorProfilerInfo2

Outros recursos

Interfaces de criação de perfil