Método ExtRemoteData::SetLongPtr (engextcpp.hpp)

Artigo
02/29/2024

A classe ExtRemoteData fornece um wrapper em torno de uma pequena seção da memória de um destino. ExtRemoteData recupera automaticamente a memória e fornece vários métodos de conveniência.

A classe ExtRemoteData inclui os seguintes construtores e métodos:

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: O nome dado a essa instância de ExtRemoteData. Esse nome é usado para fornecer mensagens de erro significativas e é definido pelo construtor ExtRemoteData::ExtRemoteData.
m_Offset: O local na memória do destino (virtual ou físico) da região de memória representada por essa instância de ExtRemoteData. Ele pode ser definido pelo construtor ExtRemoteData::ExtRemoteData ou pelos métodos ExtRemoteData::Set(Typed) ou ExtRemoteData::Set(Offset Bytes).
m_ValidOffset: Indica se o local de m_Offseté válido. Se m_ValidOffset for false, o local não será válido e a maioria dos métodos para esse objeto não funcionará. Nesse caso, os métodos ExtRemoteData::Set(Typed) ou ExtRemoteData::Set(Offset Bytes) podem ser chamados para alterar m_Offset para um local válido.
m_Bytes: O tamanho, em bytes, da região da memória representada por esse objeto. Ele pode ser definido pelo construtor ExtRemoteData::ExtRemoteData ou pelos métodos ExtRemoteData::Set(Typed) ou ExtRemoteData::Set(Offset Bytes).
M_data: O conteúdo armazenado em cache da região de memória especificada por esta instância de ExtRemoteData. Definir esse membro é opcional. Se a região da memória for grande, ela não será armazenada em cache.
m_ValidData: Indica se os dados armazenados em cache m_Data são válidos. Se m_ValidData for false, os dados armazenados em cache não serão válidos e a maioria dos métodos para esse objeto não funcionará. Nesse caso, o método ExtRemoteData::Read pode ser chamado para atualizar os dados armazenados em cache.
m_Physical: Indica se o m_Offset local está no espaço de endereço virtual do destino ou em seu espaço de endereço físico. Se m_Physical for true, o m_Offsetlocal estará no espaço de endereço físico do destino. Se m_Physical for false, o local do m_Offset estará no espaço de endereço virtual do destino.
m_SpaceFlags: Os sinalizadores DEBUG_PHYSICAL_XXX usados para acessar a memória física no destino. Esses sinalizadores só serão usados se m_Physical for true. Para obter uma descrição desses sinalizadores, consulte o método ReadPhysical2 .