Метод IDebugDataSpaces3::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, эти сведения не возвращаются.
Возвращаемое значение
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. Возможно, значение BytesRead меньше BufferSize, но был возвращен хотя бы один байт данных. |
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
Комментарии
Этот метод заполняет буфер содержимым памяти в виртуальном адресном пространстве целевого объекта.
Этот метод может ссылаться на кэш данных памяти при извлечении данных. Если данные являются переменными, например состояние оборудования, сопоставленного в памяти, используйте readVirtualUncached .
При чтении памяти, содержащей указатели, эти указатели предназначены для виртуального адресного пространства целевого объекта, а не для подсистемы. Например, если структура данных содержит строку, может потребоваться второй вызов этого метода для чтения содержимого строки.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | dbgeng.h (включая Dbgeng.h) |