Edit

Share via


IDebugHostMemory5::GetPhysicalAddressLocation method (dbgmodel.h)

The GetPhysicalAddressLocation method creates a ___location structure that represents an offset as a physical memory address. Failure is a legitimate outcome (E_NOTIMPL) if the debugger does not support physical addressing. However, if the debugger supports physical addressing but a particular target does not, GetPhysicalAddressLocation will succeed but read attempts from that ___location will fail.

On successful execution of this method, the resulting ___location can be utilized with any method that requires a ___location. This includes the creation of typed objects at a physical address. Callers are free to modify the offset of the returned ___location after the method successfully returns.

Syntax

HRESULT GetPhysicalAddressLocation(
  ULONG64  physAddr,
  Location *pPhysicalAddressLocation
);

Parameters

physAddr

The physical memory address which needs to be represented as ___location structure.

pPhysicalAddressLocation

A pointer to the storage ___location where the ___location structure representing the physical memory address will be stored.

Return value

This method returns HRESULT which indicates success or failure.

Remarks

If this method succeeds, the ___location can be utilized with any method that takes a ___location (including the creation of typed objects at a physical address).

Requirements

Requirement Value
Header dbgmodel.h

See also

IDebugHostMemory5 interface