Share via

Interface ICorDebugDataTarget

  • Artigo

Fornece uma interface de retorno de chamada que oferece acesso a um determinado processo de destino.

Métodos

Método Descrição
Método GetPlatform Fornece informações sobre a plataforma, incluindo a arquitetura do processador e o sistema operacional, no qual o processo de destino está em execução.
Método ReadVirtual Obtém um bloco de memória contígua começando no endereço especificado e o retorna no buffer fornecido.
Método GetThreadContext Solicita o contexto de thread atual para o thread especificado.

Comentários

ICorDebugDataTarget e seus métodos têm as seguintes características:

  • Os serviços de depuração chamam métodos nessa interface para acessar a memória e outros dados no processo de destino.

  • O cliente do depurador deve implementar essa interface conforme apropriado para o destino específico (por exemplo, um processo dinâmico ou um despejo de memória).

  • Os ICorDebugDataTarget métodos só podem ser invocados de dentro de métodos implementados em outras ICorDebug* interfaces. Isso garante que o cliente depurador tenha controle sobre qual thread ele é invocado e quando.

  • A ICorDebugDataTarget implementação deve sempre retornar informações atualizadas sobre o destino.

O processo de destino deve ser interrompido e não alterado de forma alguma enquanto ICorDebug* as interfaces (e, portanto, ICorDebugDataTarget os métodos) estão sendo chamados. Se o destino for um processo dinâmico e seu estado for alterado, o método ICLRDebugging::OpenVirtualProcess deverá ser chamado novamente para fornecer uma instância ICorDebugProcess de substituição.

Observação

Esta interface não pode ser chamada remotamente, seja entre computadores ou entre processos.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4

Confira também