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

2025-04-09

Метод 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, за исключением того, что он избегает использования кэша виртуальной памяти. Поэтому это полезно для чтения, по сути, переменной виртуальной памяти, например сопоставленных с памятью областей устройств, без загрязнения или недопустимого кэширования.