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

Artigo
02/23/2024

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 que estão sendo 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.

Retornar valor

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 Valores retornados para obter mais detalhes.

Comentários

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 referenciar um cache de dados de memória ao recuperar dados. Se os dados forem voláteis, como o estado de hardware mapeado na 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.