Поделиться через


Метод IDebugDataSpaces::ReadVirtual (dbgeng.h)

Метод ReadVirtual считывает память из виртуального адресного пространства целевого объекта.

Синтаксис

HRESULT ReadVirtual(
  [in]            ULONG64 Offset,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Параметры

[in] Offset

Указывает расположение в виртуальном адресном пространстве целевого объекта для чтения.

[out] Buffer

Указывает буфер для считывания памяти.

[in] BufferSize

Задает размер буфера в байтах. Это также число запрашиваемых байтов.

[out, optional] BytesRead

Получает количество считанных байтов. Если задано значение NULL, эти сведения не возвращаются.

Возвращаемое значение

Код возврата Описание
S_OK
Метод выполнен успешно. Возможно, значение BytesRead меньше BufferSize, но возвращено по крайней мере один байт данных.
 

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Комментарии

Этот метод заполняет буфер содержимым памяти в виртуальном адресном пространстве целевого объекта.

Этот метод может ссылаться на кэш данных памяти при извлечении данных. Если данные переменные, например состояние оборудования, сопоставленное с памятью, используйте readVirtualUncached .

При чтении памяти, содержащей указатели, эти указатели предназначены для виртуального адресного пространства целевого объекта, а не для подсистемы. Например, если структура данных содержит строку, для чтения содержимого строки может потребоваться второй вызов этого метода.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

IDebugDataSpaces

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

ReadVirtualUncached

WriteVirtual