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

Статья
02/06/2025

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

Синтаксис

HRESULT WriteVirtualUncached(
  [in]            ULONG64 Offset,
  [in]            PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesWritten
);

Параметры

[in] Offset

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

[in] Buffer

Указывает буфер для записи памяти из.

[in] BufferSize

Задает размер буфера в байтах. Это также число байтов, запрошенных для записи.

[out, optional] BytesWritten

Получает количество байтов, которые были записаны на самом деле. Если для него задано значение NULL, эти сведения не возвращаются.

Возвращаемое значение

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

Возвращаемый код	Описание
S_OK	Метод был по крайней мере частично успешным. BytesWritten указывает количество байтов, которые могут быть меньше BufferSize.

Замечания

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

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