Partilhar via


Método IDebugDataSpaces::ReadVirtual (dbgeng.h)

O método ReadVirtual lê a memória do espaço de endereço virtual do destino.

Sintaxe

HRESULT ReadVirtual(
  [in]            ULONG64 Offset,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Parâmetros

[in] Offset

Especifica o local no espaço de endereço virtual do destino a ser lido.

[out] Buffer

Especifica o buffer no qual ler a memória.

[in] BufferSize

Especifica o tamanho em bytes do buffer. Esse também é o número de bytes solicitados.

[out, optional] BytesRead

Recebe o número de bytes que foram lidos. Se estiver definido como NULL, essas informações não serão retornadas.

Valor de retorno

Código de retorno Descrição
S_OK
O método foi bem-sucedido. É possível que BytesRead seja menor que bufferSize, mas pelo menos um byte de dados foi retornado.
 

Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Observações

Esse método preenche o buffer com o conteúdo da memória no espaço de endereço virtual do destino.

Esse método pode fazer referência a um cache de dados de memória ao recuperar dados. Se os dados forem voláteis, como o estado de hardware mapeado pela memória, use ReadVirtualUncached.

Ao ler a memória que contém ponteiros, esses ponteiros são para o espaço de endereço virtual do destino e não para o do mecanismo. Por exemplo, se uma estrutura de dados contiver uma cadeia de caracteres, uma segunda chamada para esse método poderá ser necessária para ler o conteúdo da cadeia de caracteres.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

IDebugDataSpaces

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

ReadVirtualUncached

WriteVirtual