Interface ICorProfilerInfoICorProfilerInfo Interface

Fornece métodos para uso por infilers de código para se comunicar com o Common Language Runtime (CLR) para controlar o monitoramento de eventos e informações de solicitação.Provides methods for use by code profilers to communicate with the common language runtime (CLR) to control event monitoring and request information.

Observação

Cada método na ICorProfilerInfo interface retorna um HRESULT para indicar êxito ou falha.Each method in the ICorProfilerInfo interface returns an HRESULT to indicate success or failure. Consulte CorError. h para obter uma lista de possíveis códigos de retorno.See CorError.h for a list of possible return codes.

MétodosMethods

MétodoMethod DescriçãoDescription
Método BeginInprocDebuggingBeginInprocDebugging Method Inicializa o suporte à depuração em processo.Initializes in-process debugging support. Esse método é obsoleto no .NET Framework versão 2,0.This method is obsolete in the .NET Framework version 2.0.
Método EndInprocDebuggingEndInprocDebugging Method Desliga uma sessão de depuração em processo.Shuts down an in-process debugging session. Esse método é obsoleto no .NET Framework versão 2,0.This method is obsolete in the .NET Framework version 2.0.
Método ForceGCForceGC Method Força a coleta de lixo a ocorrer dentro do tempo de execução.Forces garbage collection to occur within the runtime.
Método GetAppDomainInfoGetAppDomainInfo Method Obtém informações sobre o domínio de aplicativo especificado.Gets information about the specified application domain.
Método GetAssemblyInfoGetAssemblyInfo Method Obtém informações sobre o assembly especificado.Gets information about the specified assembly.
Método GetClassFromObjectGetClassFromObject Method Obtém o ClassID de umGets the ClassID of an

objeto, dado seu ObjectID .object, given its ObjectID.
Método GetClassFromTokenGetClassFromToken Method Obtém a ID da classe, dado o token de metadados.Gets the ID of the class, given the metadata token. Esse método é obsoleto no .NET Framework versão 2,0.This method is obsolete in the .NET Framework version 2.0. Em vez disso, use o método ICorProfilerInfo2:: GetClassFromTokenAndTypeArgs .Use the ICorProfilerInfo2::GetClassFromTokenAndTypeArgs method instead.
Método GetClassIDInfoGetClassIDInfo Method Obtém o módulo pai e o token de metadados para a classe especificada.Gets the parent module and the metadata token for the specified class.
Método GetCodeInfoGetCodeInfo Method Obtém a extensão do código nativo associado à ID da função especificada.Gets the extent of native code associated with the specified function ID. Esse método é obsoleto.This method is obsolete. Em vez disso, use o método ICorProfilerInfo2:: GetCodeInfo2 .Use the ICorProfilerInfo2::GetCodeInfo2 method instead.
Método GetCurrentThreadIDGetCurrentThreadID Method Obtém a ID do thread atual, se for um thread gerenciado.Gets the ID of the current thread, if it is a managed thread.
Método GetEventMaskGetEventMask Method Obtém as categorias de evento atuais para as quais o criador de perfil deseja receber notificações de eventos do CLR.Gets the current event categories for which the profiler wants to receive event notifications from the CLR.
Método GetFunctionFromIPGetFunctionFromIP Method Mapeia um ponteiro de instrução de código gerenciado para um FunctionID .Maps a managed code instruction pointer to a FunctionID.
Método GetFunctionFromTokenGetFunctionFromToken Method Obtém a ID de uma função.Gets the ID of a function. Esse método é obsoleto no .NET Framework versão 2,0.This method is obsolete in the .NET Framework version 2.0. Em vez disso, use o método ICorProfilerInfo2:: GetFunctionFromTokenAndTypeArgs .Use the ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs method instead.
Método GetFunctionInfoGetFunctionInfo Method Obtém a classe pai e o token de metadados para a função especificada.Gets the parent class and metadata token for the specified function.
Método GetHandleFromThreadGetHandleFromThread Method Mapeia a ID de um thread para um identificador de thread do Win32.Maps the ID of a thread to a Win32 thread handle.
Método GetILFunctionBodyGetILFunctionBody Method Obtém um ponteiro para o corpo de um método no código da MSIL (Microsoft Intermediate Language), começando em seu cabeçalho.Gets a pointer to the body of a method in Microsoft intermediate language (MSIL) code, starting at its header.
Método GetILFunctionBodyAllocatorGetILFunctionBodyAllocator Method Obtém uma interface que fornece um método para alocar memória a ser usada para alternar o corpo de um método no código MSIL.Gets an interface that provides a method to allocate memory to be used for swapping out the body of a method in MSIL code.
Método GetILToNativeMappingGetILToNativeMapping Method Obtém um mapa de deslocamentos MSIL para deslocamentos nativos para o código contido na função especificada.Gets a map from MSIL offsets to native offsets for the code contained in the specified function.
Método GetInprocInspectionInterfaceGetInprocInspectionInterface Method Obtém um objeto que pode ser consultado para uma interface ICorDebugProcess.Gets an object that can be queried for an ICorDebugProcess interface. Esse método é obsoleto no .NET Framework versão 2,0.This method is obsolete in the .NET Framework version 2.0.
Método GetInprocInspectionIThisThreadGetInprocInspectionIThisThread Method Obtém um objeto que pode ser consultado para a interface ICorDebugThread.Gets an object that can be queried for the ICorDebugThread interface. Esse método é obsoleto no .NET Framework versão 2,0.This method is obsolete in the .NET Framework version 2.0.
Método GetModuleInfoGetModuleInfo Method Dada uma ID de módulo, retorna o nome do arquivo do módulo e a ID do assembly pai do módulo.Given a module ID, returns the file name of the module and the ID of the module's parent assembly.
Método GetModuleMetaDataGetModuleMetaData Method Obtém uma instância de interface de metadados que mapeia para o módulo especificado.Gets a metadata interface instance that maps to the specified module.
Método GetObjectSizeGetObjectSize Method Obtém o tamanho de um objeto especificado.Gets the size of a specified object.
Método GetThreadContextGetThreadContext Method Obtém a identidade de contexto atualmente associada ao thread especificado.Gets the context identity currently associated with the specified thread.
Método GetThreadInfoGetThreadInfo Method Obtém a identidade do Thread Win32 atual para o thread especificado.Gets the current Win32 thread identity for the specified thread.
Método GetTokenAndMetadataFromFunctionGetTokenAndMetadataFromFunction Method Obtém o token de metadados e uma instância da interface de metadados que pode ser usada em relação ao token para a função especificada.Gets the metadata token and an instance of the metadata interface that can be used against the token for the specified function.
Método IsArrayClassIsArrayClass Method Determina se a classe especificada é uma classe de matriz.Determines whether the specified class is an array class.
Método SetEnterLeaveFunctionHooksSetEnterLeaveFunctionHooks Method Especifica funções implementadas pelo Profiler a serem chamadas em "Inserir", "deixar" e "tailcall" ganchos de funções gerenciadas.Specifies profiler-implemented functions to be called on "enter", "leave", and "tailcall" hooks of managed functions.
Método SetEventMaskSetEventMask Method Define um valor que especifica os tipos de eventos para os quais o criador de perfil deseja receber a notificação do CLR.Sets a value that specifies the types of events for which the profiler wants to receive notification from the CLR.
Método SetFunctionIDMapperSetFunctionIDMapper Method Especifica a função implementada pelo criador de perfil que será chamada para mapear FunctionID valores para valores alternativos, que são passados para os ganchos de entrada/saída da função do criador de perfil.Specifies the profiler-implemented function that will be called to map FunctionID values to alternative values, which are passed to the profiler's function entry/exit hooks.
Método SetFunctionReJITSetFunctionReJIT Method Não implementado.Not implemented. Não use.Do not use.
Método SetILFunctionBodySetILFunctionBody Method Substitui o corpo da função especificada no módulo especificado.Replaces the body of the specified function in the specified module.
Método SetILInstrumentedCodeMapSetILInstrumentedCodeMap Method Especifica como os deslocamentos de um MSIL original da função especificada são mapeados para os novos deslocamentos do MSIL do criador de perfil da função.Specifies how the offsets of a specified function's original MSIL map to the new offsets of the function's profiler-modified MSIL.

ComentáriosRemarks

Um criador de perfil chama um método na ICorProfilerInfo interface para se comunicar com o CLR para controlar as informações de solicitação e monitoramento de eventos.A profiler calls a method in the ICorProfilerInfo interface to communicate with the CLR to control event monitoring and request information.

Os métodos da ICorProfilerInfo interface são implementados pelo CLR usando o modelo de thread livre.The methods of the ICorProfilerInfo interface are implemented by the CLR using the free-threaded model. Cada método retorna um HRESULT para indicar êxito ou falha.Each method returns an HRESULT to indicate success or failure. Consulte CorError. h para obter uma lista de possíveis códigos de retorno.See CorError.h for a list of possible return codes.

O CLR passa, por meio da implementação do criador de perfil de ICorProfilerCallback:: Initialize, uma ICorProfilerInfo interface para cada criador de perfil de código durante a inicialização.The CLR passes, via the profiler's implementation of ICorProfilerCallback::Initialize, an ICorProfilerInfo interface to each code profiler during initialization. Um criador de perfil de código pode então chamar métodos da ICorProfilerInfo interface para obter informações sobre o código gerenciado que está sendo executado sob o controle do CLR.A code profiler can then call methods of the ICorProfilerInfo interface to get information about managed code being executed under the control of the CLR.

RequisitosRequirements

Plataformas: confira Requisitos do sistema.Platforms: See System Requirements.

Cabeçalho: CorProf. idl, CorProf. hHeader: CorProf.idl, CorProf.h

Biblioteca: CorGuids.libLibrary: CorGuids.lib

.NET Framework versões:Disponível desde o 2.0Available since 2.0.NET Framework Versions: Disponível desde o 2.0Available since 2.0

Consulte tambémSee also