Interface ICorDebugDataTargetICorDebugDataTarget Interface

Fornece uma interface de retorno de chamada que oferece acesso a um determinado processo de destino.Provides a callback interface that provides access to a particular target process.

MétodosMethods

MétodoMethod DescriçãoDescription
Método GetPlatformGetPlatform Method Fornece informações sobre a plataforma, incluindo arquitetura do processador e sistema operacional, em que o processo de destino está em execução.Provides information about the platform, including processor architecture and operating system, on which the target process is running.
Método ReadVirtualReadVirtual Method Obtém um bloco de memória contígua a partir do endereço especificado e a retorna no buffer fornecido.Gets a block of contiguous memory starting at the specified address, and returns it in the supplied buffer.
Método GetThreadContextGetThreadContext Method Solicita o contexto de thread atual para o thread especificado.Requests the current thread context for the specified thread.

ComentáriosRemarks

ICorDebugDataTarget e seus métodos têm as seguintes características:ICorDebugDataTarget and its methods have the following characteristics:

  • Os serviços de depuração chamam os métodos nessa interface para acessar a memória e outros dados no processo de destino.The debugging services call methods on this interface to access memory and other data in the target process.

  • O cliente do depurador deve implementar essa interface conforme apropriado para o destino específico (por exemplo, um processo ao vivo ou um despejo de memória).The debugger client must implement this interface as appropriate for the particular target (for example, a live process or a memory dump).

  • Os ICorDebugDataTarget métodos podem ser invocados somente de dentro de métodos implementados em outras ICorDebug* interfaces.The ICorDebugDataTarget methods can be invoked only from within methods implemented in other ICorDebug* interfaces. Isso garante que o cliente do depurador tenha controle sobre qual thread ele é invocado e quando.This ensures that the debugger client has control over which thread it is invoked on, and when.

  • A ICorDebugDataTarget implementação sempre deve retornar informações atualizadas sobre o destino.The ICorDebugDataTarget implementation must always return up-to-date information about the target.

O processo de destino deve ser interrompido e não alterado de nenhuma forma enquanto as ICorDebug* interfaces (e, portanto, os ICorDebugDataTarget métodos) estão sendo chamadas.The target process should be stopped and not changed in any way while ICorDebug* interfaces (and therefore ICorDebugDataTarget methods) are being called. Se o destino for um processo ao vivo e seu estado for alterado, o método ICLRDebugging:: OpenVirtualProcess precisará ser chamado novamente para fornecer uma instância de ICorDebugProcess substituta.If the target is a live process and its state changes, the ICLRDebugging::OpenVirtualProcess method has to be called again to provide a replacement ICorDebugProcess instance.

Observação

Esta interface não dá suporte para chamada remota, seja entre computadores ou processos cruzados.This interface does not support being called remotely, either cross-machine or cross-process.

RequisitosRequirements

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

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

Biblioteca: CorGuids.libLibrary: CorGuids.lib

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

Consulte tambémSee also