Partilhar via

ICorDebugDataTarget Interface

  • Artigo

Fornece uma interface de chamada de retorno que fornece acesso a um processo de destino específico.

Métodos

Método Descrição
Método GetPlatform Fornece informações sobre a plataforma, incluindo a arquitetura do processador e o sistema operativo, no qual o processo de destino está em execução.
Método ReadVirtual Obtém um bloco de memória contígua a partir do endereço especificado e devolve-o na memória intermédia fornecida.
Método GetThreadContext Pede o contexto de thread atual para o thread especificado.

Observações

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

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

  • O cliente de depurador tem de implementar esta interface conforme adequado para o destino específico (por exemplo, um processo em direto ou uma captura de memória).

  • Os ICorDebugDataTarget métodos só podem ser invocados a partir de métodos implementados noutras ICorDebug* interfaces. Isto garante que o cliente de depurador tem controlo sobre o thread em que é invocado e quando.

  • A ICorDebugDataTarget implementação tem de devolver sempre informações atualizadas sobre o destino.

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

Nota

Esta interface não suporta ser chamada remotamente, nem entre máquinas nem em processos cruzados.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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

Ver também