Interface ICorProfilerInfo3

  • Artigo

Fornece métodos que os criadores de perfis de código usam para se comunicar com o Common Language Runtime (CLR) para controlar o monitoramento de eventos e solicitar informações. A interface ICorProfilerInfo3 é uma extensão da interface ICorProfilerInfo2. Ela fornece novos métodos com compatibilidade no .NET Framework 4 e versões posteriores.

Métodos

Método Descrição
Método EnumJITedFunctions Retorna um enumerador para todas as funções anteriormente recompiladas por JIT.
Método EnumModules Retorna um enumerador que fornece métodos para iterar sequencialmente por meio de uma coleção de módulos gerenciados que são carregados no aplicativo.
Método GetAppDomainsContainingModule Obtém os identificadores dos domínios do aplicativo nos quais o módulo especificado foi carregado.
Método GetFunctionEnter3Info Fornece o registro de ativação e as informações de argumento da função que está sendo relatada ao criador de perfil pela função FunctionEnter3WithInfo. Pode ser chamado somente durante o retorno de chamada FunctionEnter3WithInfo.
Método GetFunctionLeave3Info Fornece o registro de ativação e o valor retornado da função que está sendo relatada ao criador de perfil pela função FunctionLeave3WithInfo. Pode ser chamado somente durante o retorno de chamada FunctionLeave3WithInfo.
Método GetFunctionTailcall3Info Fornece o registro de ativação da função que está sendo relatada ao criador de perfil pela função FunctionTailcall3WithInfo. Pode ser chamado somente durante o retorno de chamada FunctionTailcall3WithInfo.
Método GetModuleInfo2 Dada uma ID de módulo retorna o nome do arquivo do módulo, a ID do assembly pai do módulo e um bitmask que descreve as propriedades do módulo.
Método GetRuntimeInformation Fornece informações de versão sobre o runtime cujo perfil está sendo criado.
Método GetStringLayout2 Obtém informações sobre o layout de um objeto da cadeia de caracteres.
Método GetThreadStaticAddress2 Obtém o endereço do campo estático de thread especificado que está no escopo do domínio do aplicativo e thread especificados.
Método RequestProfilerDetach Instrui o runtime a desanexar o criador de perfil.
Método SetEnterLeaveFunctionHooks3 Especifica as funções implementadas pelo criador de perfil que serão chamadas nas funções FunctionEnter3, FunctionLeave3 e FunctionTailcall3.
Método SetEnterLeaveFunctionHooks3WithInfo Especifica as funções implementadas pelo criador de perfil que serão chamadas nos ganchos FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo de funções gerenciadas.
Método SetFunctionIDMapper2 Especifica a função implementada pelo criador de perfil que será chamada para mapear valores FunctionID para valores alternativos, que são passados para os ganchos de entrada/saída da função do criador de perfil. Esse método estende ICorProfilerInfo::SetFunctionIDMapper com um parâmetro que os criadores de perfil podem usar para desambiguar entre runtimes.

Comentários

O CLR implementa os métodos da interface ICorProfilerInfo3 usando o modelo de thread livre. Cada método retorna um HRESULT para indicar êxito ou falha. Para obter uma lista de possíveis códigos de retorno, consulte o arquivo CorError.h.

O CLR passa uma interface ICorProfilerInfo3 para cada criador de perfil de código durante a inicialização, usando a implementação pelo criador de perfil do método ICorProfilerCallback::Initialize ou ICorProfilerCallback3::InitializeForAttach. Em seguida, um criador de perfil de código pode chamar os métodos ICorProfilerInfo3 para receber informações sobre o código gerenciado que está sendo executado sob o controle do CLR.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

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

Confira também