IDebugDataSpaces2::ReadVirtualUncached method (dbgeng.h)

Article
10/21/2021

The ReadVirtualUncached method reads memory from the target's virtual address space.

Syntax

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

Parameters

[in] Offset

Specifies the location in the target's virtual address space to be read.

[out] Buffer

Specifies the buffer to read the memory into.

[in] BufferSize

Specifies the size in bytes of the buffer. This is also the number of bytes being requested.

[out, optional] BytesRead

Receives the number of bytes that were read. If it is set to NULL, this information is not returned.

Return value

Return code	Description
S_OK	The method was successful. It is possible that BytesRead is less than BufferSize, but at least one byte of data is being returned.

This method can also return error values. See Return Values for more details.

Remarks

This method fills the buffer with the contents of the memory in the target's virtual address space.

This method behaves identically to ReadVirtual, except that it avoids using the virtual memory cache. It is therefore useful for reading inherently volatile virtual memory, such as memory-mapped device areas, without contaminating or invalidating the cache.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)