Compartilhar via


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

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 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 o bufferSize, mas pelo menos um byte de dados está sendo 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 se comporta de forma idêntica a 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.

Requisitos

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

Consulte também

IDebugDataSpaces

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

ReadVirtual

WriteVirtualUncached