Interface de ICorProfilerInfo3
Fornece métodos que geradores de perfis de código usam para se comunicar com o common language runtime (CLR) para controlar a monitoração de eventos e para solicitar informações. O ICorProfilerInfo3 interface é uma extensão de ICorProfilerInfo2 interface. Ele oferece novos métodos com suporte no .NET Framework versão 4 e versões posteriores.
Métodos
Método |
Descrição |
|---|---|
Retorna um enumerador para todas as funções previamente compilado em JIT. |
|
Retorna um enumerador que fornece métodos para seqüencialmente iterar por meio de um conjunto de módulos gerenciados que são carregados no aplicativo. |
|
Obtém os identificadores dos domínios de aplicativo no qual o módulo especificado foi carregado. |
|
Fornece as informações de pilha quadro e o argumento da função que está sendo relatada o criador de perfil, o FunctionEnter3WithInfo função; pode ser chamado somente durante o FunctionEnter3WithInfo retorno de chamada. |
|
Fornece o quadro de pilha e o valor de retorno da função que está sendo relatado o criador de perfil, o FunctionLeave3WithInfo função função; pode ser chamado somente durante o FunctionLeave3WithInfo retorno de chamada. |
|
Fornece o quadro de pilhas da função que está sendo relatado o criador de perfil, o FunctionTailcall3WithInfo função; pode ser chamado somente durante o FunctionTailcall3WithInfo retorno de chamada. |
|
Dada uma identificação de módulo, retorna o nome do arquivo do módulo, a identificação do pai do módulo assembly e um bitmask que descreve as propriedades do módulo. |
|
Fornece informações de versão sobre o tempo de execução está sendo perfilada. |
|
Obtém informações sobre o layout de um objeto de seqüência de caracteres. |
|
Obtém o endereço do campo de thread estático especificado está no escopo do segmento especificado e do domínio de aplicativo. |
|
Instrui o runtime para desanexar o profiler. |
|
Especifica as funções implementadas o profiler que serão chamadas na FunctionEnter3, FunctionLeave3, e FunctionTailcall3 funções. |
|
Método de ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo |
Especifica as funções implementadas o profiler que serão chamadas na FunctionEnter3WithInfo, FunctionLeave3WithInfo, e FunctionTailcall3WithInfo ganchos de funções gerenciadas. |
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. Esse método amplia ICorProfilerInfo::SetFunctionIDMapper com um parâmetro que geradores de perfis podem usar a ambigüidade entre os tempos de execução. |
Comentários
O CLR implementa os métodos de ICorProfilerInfo3 interface usando o modelo de segmentação livre. Cada método retorna um HRESULT para indicar sucesso ou falha. Para obter uma lista dos códigos de retorno possíveis, consulte o arquivo CORERROR.
O CLR passa um ICorProfilerInfo3 interface para cada código de perfil durante a inicialização, usando a implementação do profiler a ICorProfilerCallback::Initialize ou ICorProfilerCallback3::InitializeForAttach método. Um gerador de perfil de código pode chamar o ICorProfilerInfo3 métodos para obter informações sobre o código gerenciado que está sendo executado sob o controle do CLR.
Para obter informações sobre AppDomainID e FunctionID valores, consulte Criação de perfil e IDs de notificação de tempo de execução.
Requisitos
Plataformas: Consulte Requisitos de sistema do .NET Framework.
Cabeçalho: Corprof. idl, CorProf.h
Biblioteca: CorGuids.lib
.NET Framework versões: 4