Partilhar via


ICorProfilerInfo2 Interface

Fornece métodos que os geradores de 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 ICorProfilerInfo2 interface é uma extensão da interface ICorProfilerInfo . Ou seja, fornece novos métodos suportados no .NET Framework versão 2.0 e versões posteriores.

Métodos

Método Descrição
Método DoStackSnapshot Orienta a pilha do thread especificado para comunicar frames de chamadas geridas ao gerador de perfis.
Método EnumModuleFrozenObjects Obtém um enumerador que permite a iteração através dos objetos congelados no módulo especificado.
GetAppDomainStaticAddress Method Obtém o endereço do campo estático de domínio da aplicação especificado que está no âmbito do domínio de aplicação especificado.
Método GetArrayObjectInfo Obtém informações detalhadas sobre um objeto de matriz.
Método GetBoxClassLayout Obtém informações sobre o esquema de classe de um tipo de valor especificado que está em caixa.
Método GetClassFromTokenAndTypeArgs Obtém o ClassID de um tipo com o token de metadados especificados e os ClassID valores de qualquer tipo de argumentos.
Método GetClassIDInfo2 Obtém o módulo principal da classe genérica especificada, o token de metadados para a classe, o ClassID da classe principal e o ClassID argumento para cada tipo, se estiver presente, da classe .
Método GetClassLayout Obtém informações sobre o esquema, na memória, dos campos definidos pela classe especificada. Ou seja, este método obtém os desvios dos campos da classe.
Método GetCodeInfo2 Obtém as extensões do código nativo associado ao especificado FunctionID.
GetContextStaticAddress Method Obtém o endereço do campo estático de contexto especificado que está no âmbito do contexto especificado.
Método GetFunctionFromTokenAndTypeArgs Obtém o FunctionID de uma função com o token de metadados especificado, que contém a classe e ClassID os valores de qualquer tipo de argumentos.
Método GetFunctionInfo2 Obtém a classe principal, o token de metadados e o ClassID argumento de cada tipo, se estiver presente, de uma função.
Método GetGenerationBounds Obtém as regiões de memória (os segmentos da área dinâmica para dados) que compõem as gerações da área dinâmica para memória recolhida.
Método GetNotifiedExceptionClauseInfo Obtém o endereço nativo e as informações de frame para a cláusula de exceção (catch//finallyfilter) que está prestes a ser executada ou que acabou de ser executada.
Método GetObjectGeneration Obtém o segmento da área dinâmica para dados que contém o objeto especificado.
GetRVAStaticAddress Method Obtém o endereço do campo estático do endereço virtual relativo (RVA) especificado.
GetStaticFieldInfo Method Obtém o âmbito no qual o campo especificado é estático.
Método GetStringLayout Obtém informações sobre o esquema de um objeto de cadeia.
Método GetThreadAppDomain Obtém o ID do domínio da aplicação no qual o thread especificado está atualmente a executar código.
GetThreadStaticAddress Method Obtém o endereço do campo estático de thread especificado que está no âmbito do thread especificado.
Método SetEnterLeaveFunctionHooks2 Especifica as funções implementadas pelo gerador de perfis a chamar nos hooks "enter", "leave" e "tailcall" das funções geridas.

Observações

Um gerador de perfis chama um método na ICorProfilerInfo2 interface para comunicar com o CLR para controlar a monitorização de eventos e pedir informações.

Os métodos da ICorProfilerInfo2 interface são implementados pelo CLR 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 ICorProfilerInfo2 interface a cada gerador de perfis de código durante a inicialização, utilizando a implementação do gerador de perfis de ICorProfilerCallback::Initialize. Em seguida, um gerador de perfis de código pode chamar métodos da ICorProfilerInfo2 interface para obter informações sobre o código gerido a ser executado sob o controlo do CLR.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: CorProf.idl, CorProf.h

Biblioteca: CorGuids.lib

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

Ver também