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

Статья
08/07/2023

Метод 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 .

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