ICorProfilerInfo3 Interface
Fornece métodos que os perfis de código utilizam para comunicar com o runtime de linguagem comum (CLR) para controlar a monitorização de eventos e pedir informações. A ICorProfilerInfo3 interface é uma extensão da interface ICorProfilerInfo2 . Fornece novos métodos suportados nas versões .NET Framework 4 e posteriores.
Métodos
| Método | Descrição |
|---|---|
| Método EnumJITedFunctions | Devolve um enumerador para todas as funções compiladas anteriormente pelo JIT. |
| Método EnumModules | Devolve um enumerador que fornece métodos para iterar sequencialmente através de uma coleção de módulos geridos que são carregados para a aplicação. |
| Método GetAppDomainsContainingModule | Obtém os identificadores dos domínios da aplicação nos quais o módulo especificado foi carregado. |
| Método GetFunctionEnter3Info | Fornece a moldura da pilha e as informações de argumento da função que está a ser comunicada ao gerador de perfis pela função FunctionEnter3WithInfo ; só pode ser chamada durante a FunctionEnter3WithInfo chamada de retorno. |
| Método GetFunctionLeave3Info | Fornece o fotograma de pilha e o valor devolvido da função que está a ser comunicada ao gerador de perfis pela função FunctionLeave3WithInfo ; só pode ser chamada durante a FunctionLeave3WithInfo chamada de retorno. |
| Método GetFunctionTailcall3Info | Fornece a moldura de pilha da função que está a ser comunicada ao gerador de perfis pela função FunctionTailcall3WithInfo ; só pode ser chamada durante a FunctionTailcall3WithInfo chamada de retorno. |
| Método GetModuleInfo2 | Dado um ID de módulo, devolve o nome de ficheiro do módulo, o ID da assemblagem principal do módulo e uma máscara de bits que descreve as propriedades do módulo. |
| Método GetRuntimeInformation | Fornece informações de versão sobre o runtime que está a ser perfilado. |
| Método GetStringLayout2 | Obtém informações sobre o esquema de um objeto de cadeia. |
| Método GetThreadStaticAddress2 | Obtém o endereço do campo estático de thread especificado que está no âmbito do thread especificado e do domínio da aplicação. |
| Método RequestProfilerDetach | Instrui o runtime a desanexar o gerador de perfis. |
| Método SetEnterLeaveFunctionHooks3 | Especifica as funções implementadas pelo profiler que serão chamadas nas funções FunctionEnter3, FunctionLeave3 e FunctionTailcall3 . |
| Método SetEnterLeaveFunctionHooks3WithInfo | Especifica as funções implementadas pelo profiler que serão chamadas nos hooks FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo das funções geridas. |
| Método SetFunctionIDMapper2 | Especifica a função implementada pelo profiler que será chamada para mapear FunctionID valores para valores alternativos, que são transmitidos para os ganchos de entrada/saída da função do gerador de perfis. Este método expande ICorProfilerInfo::SetFunctionIDMapper com um parâmetro que os perfis podem utilizar para desambiguar entre runtimes. |
Observações
O CLR implementa os métodos da ICorProfilerInfo3 interface com o modelo de thread livre. Cada método devolve um HRESULT para indicar êxito ou falha. Para obter uma lista de possíveis códigos de retorno, consulte o ficheiro CorError.h.
O CLR transmite uma ICorProfilerInfo3 interface a cada gerador de perfis de código durante a inicialização, utilizando a implementação do profiler do método ICorProfilerCallback::Initialize ou ICorProfilerCallback3::InitializeForAttach . Um gerador de perfis de código pode, em seguida, chamar os ICorProfilerInfo3 métodos para obter informações sobre o código gerido que está a ser executado sob o controlo do CLR.
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: CorProf.idl, CorProf.h
Biblioteca: CorGuids.lib
.NET Framework Versões: Disponível desde 4
