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

Статья
08/07/2023

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