Hardware Dev Center

ExtRemoteData class

The ExtRemoteData class provides a wrapper around a small section of a target's memory. ExtRemoteData automatically retrieves the memory and provides a number of convenience methods.

The ExtRemoteData class includes the following constructors and methods:

ExtRemoteData

Set(Typed)

Set(Offset Bytes)

Read

Write

GetData

GetChar

GetUchar

GetBoolean

GetStdBool

GetW32Bool

GetShort

GetUshort

GetLong

GetUlong

GetLong64

GetUlong64

GetFloat

GetDouble

GetLongPtr

GetUlongPtr

GetPtr

ReadBuffer

WriteBuffer

GetString

class ExtRemoteData
{
public:
    PCSTR  m_Name;
    ULONG64  m_Offset;
    bool  m_ValidOffset;
    ULONG  m_Bytes;
    ULONG64  m_Data;
    bool  m_ValidData;
    bool  m_Physical;
    ULONG  m_SpaceFlags;
};

m_Name

The name given to this instance of ExtRemoteData. This name is used to provide meaningful error messages and is set by the constructor, ExtRemoteData::ExtRemoteData.

m_Offset

The location in the target's memory (virtual or physical) of the region of memory represented by this instance of ExtRemoteData. It can be set by the ExtRemoteData::ExtRemoteData constructor or by the ExtRemoteData::Set(Typed) or ExtRemoteData::Set(Offset Bytes) methods.

m_ValidOffset

Indicates whether the m_Offsetlocation is valid. If m_ValidOffset is false, the location is not valid and most of the methods for this object will not work. In this case, the ExtRemoteData::Set(Typed) or ExtRemoteData::Set(Offset Bytes) methods can be called to change m_Offset to a valid location.

m_Bytes

The size, in bytes, of the region of memory represented by this object. It can be set by the ExtRemoteData::ExtRemoteData constructor or by the ExtRemoteData::Set(Typed) or ExtRemoteData::Set(Offset Bytes) methods.

m_Data

The cached contents of the region of memory specified by this instance of ExtRemoteData. Setting this member is optional. If the region of memory is large, it will not be cached.

m_ValidData

Indicates whether the m_Data cached data is valid. If m_ValidData is false, the cached data is not valid and most of the methods for this object will not work. In this case, the ExtRemoteData::Read method can be called to refresh the cached data.

m_Physical

Indicates whether the m_Offset location is in the target's virtual address space or in its physical address space. If m_Physical is true, the m_Offsetlocation is in the target's physical address space. If m_Physical is false, the m_Offset location is in the target's virtual address space.

m_SpaceFlags

The DEBUG_PHYSICAL_XXX flags used for accessing physical memory on the target. These flags are only used if m_Physical is true. For a description of these flags, see the ReadPhysical2 method.

Requirements

Header

Engextcpp.h (include Engextcpp.hpp)

See also

ExtRemoteData::ExtRemoteData
ExtRemoteData::Read
ExtRemoteData::Set(Typed)
ExtRemoteData::Set(Offset Bytes)
ReadPhysical2

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft