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