Método IDebugDataSpaces2::ReadVirtualUncached (dbgeng.h)

Artigo
02/23/2024

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

Sintaxe

HRESULT ReadVirtualUncached(
  [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 está sendo 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 se comporta de forma idêntica ao ReadVirtual, exceto pelo fato de evitar o uso do cache de memória virtual. Portanto, é útil para ler memória virtual inerentemente volátil, como áreas de dispositivo mapeadas pela memória, sem contaminar ou invalidar o cache.