Edit

ReadGuestPhysicalAddress function

  • Article

Reads from the saved state file the given guest physical address range and then it is written into the supplied buffer. If BytesRead returns something lower than BufferSize, then the end of memory has been reached.

Syntax

HRESULT
WINAPI
ReadGuestPhysicalAddress(
    _In_        VM_SAVED_STATE_DUMP_HANDLE  VmSavedStateDumpHandle,
    _In_        GUEST_PHYSICAL_ADDRESS      PhysicalAddress,
    _Out_writes_bytes_(BufferSize) LPVOID   Buffer,
    _In_        UINT32                      BufferSize,
    _Out_opt_   UINT32*                     BytesRead
    );

Parameters

VmSavedStateDumpHandle

Supplies a handle to a dump provider instance.

PhysicalAddress

Supplies the physical address to read.

Buffer

Returns the read memory range on the given address.

BufferSize

Supplies the requested byte count to read.

BytesRead

Optionally returns the bytes actually read

Return Value

If the operation completes successfully, the return value is S_OK.

Requirements

Parameter Description
Minimum supported client Windows 10, version 1607
Minimum supported server Windows Server 2016
Target Platform Windows
Library ComputeCore.ext
Dll ComputeCore.ext