Méthode ExtRemoteData ::SetUchar (engextcpp.hpp)

Article
02/29/2024

La classe ExtRemoteData fournit un wrapper autour d’une petite section de la mémoire d’une cible. ExtRemoteData récupère automatiquement la mémoire et fournit un certain nombre de méthodes pratiques.

La classe ExtRemoteData inclut les constructeurs et méthodes suivants :

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: Nom donné à cette instance d’ExtRemoteData. Ce nom est utilisé pour fournir des messages d’erreur significatifs et est défini par le constructeur ExtRemoteData ::ExtRemoteData.
m_Offset: Emplacement dans la mémoire de la cible (virtuelle ou physique) de la région de mémoire représentée par cette instance d’ExtRemoteData. Il peut être défini par le constructeur ExtRemoteData ::ExtRemoteData ou par les méthodes ExtRemoteData ::Set(Typed) ou ExtRemoteData ::Set(Offset Bytes).
m_ValidOffset: Indique si l’emplacement m_Offsetest valide. Si m_ValidOffset a la valeur false, l’emplacement n’est pas valide et la plupart des méthodes de cet objet ne fonctionnent pas. Dans ce cas, les méthodes ExtRemoteData ::Set(Typed) ou ExtRemoteData ::Set(Offset Bytes) peuvent être appelées pour modifier m_Offset à un emplacement valide.
m_Bytes: Taille, en octets, de la région de mémoire représentée par cet objet. Il peut être défini par le constructeur ExtRemoteData ::ExtRemoteData ou par les méthodes ExtRemoteData ::Set(Typed) ou ExtRemoteData ::Set(Offset Bytes).
m_Data: Le contenu mis en cache de la région de mémoire spécifiée par cette instance d’ExtRemoteData. La définition de ce membre est facultative. Si la région de mémoire est grande, elle ne sera pas mise en cache.
m_ValidData: Indique si le m_Data données mises en cache est valide. Si m_ValidData a la valeur false, les données mises en cache ne sont pas valides et la plupart des méthodes de cet objet ne fonctionnent pas. Dans ce cas, la méthode ExtRemoteData ::Read peut être appelée pour actualiser les données mises en cache.
m_Physical: Indique si l’emplacement m_Offset se trouve dans l’espace d’adressage virtuel de la cible ou dans son espace d’adressage physique. Si m_Physical a la valeur true, l’emplacement m_Offsetse trouve dans l’espace d’adressage physique de la cible. Si m_Physical a la valeur false, l’emplacement m_Offset se trouve dans l’espace d’adressage virtuel de la cible.
m_SpaceFlags: Indicateurs DEBUG_PHYSICAL_XXX utilisés pour accéder à la mémoire physique sur la cible. Ces indicateurs sont utilisés uniquement si m_Physical a la valeur true. Pour obtenir une description de ces indicateurs, consultez la méthode ReadPhysical2 .