IDebugDataSpaces4::ReadPhysical2 method (dbgeng.h)

Article
10/21/2021

The ReadPhysical2 method reads the target's memory from the specified physical address.

Syntax

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

Parameters

[in] Offset

Specifies the physical address of the memory to read.

[in] Flags

Specifies the properties of the physical memory to be read. This must match the way the physical memory was advertised to the operating system on the target. Possible values are listed in the following table.

Value	Description
DEBUG_PHYSICAL_DEFAULT	Use the default memory caching.
DEBUG_PHYSICAL_CACHED	The physical memory is cached.
DEBUG_PHYSICAL_UNCACHED	The physical memory is uncached.
DEBUG_PHYSICAL_WRITE_COMBINED	The physical memory is write-combined.

[out] Buffer

Receives the memory that is read.

[in] BufferSize

Specifies the size, in bytes, of the Buffer buffer. This is the maximum number of bytes that will be read.

[out, optional] BytesRead

Receives the number of bytes read from the target's memory. If BytesRead is NULL, this information is not returned.

Return value

Return code	Description
S_OK	The method was successful.

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

Remarks

This method is only available in kernel-mode debugging.

The flags DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED, and DEBUG_PHYSICAL_WRITE_COMBINED can only be used when the target is a live kernel target that is being debugged in the standard way (using a COM port, 1394 bus, or named pipe).

Requirements

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