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


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

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

Синтаксис

HRESULT ReadVirtualUncached(
  [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, но возвращается по крайней мере один байт данных.
 

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

Комментарии

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

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

Требования

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

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

IDebugDataSpaces

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

ReadVirtual

WriteVirtualUncached