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

Статья
02/06/2025

Метод FillVirtual записывает шаблон байтов в виртуальную память целевого объекта. Шаблон записывается многократно, пока указанный диапазон памяти не будет заполнен.

Синтаксис

HRESULT FillVirtual(
  [in]            ULONG64 Start,
  [in]            ULONG   Size,
  [in]            PVOID   Pattern,
  [in]            ULONG   PatternSize,
  [out, optional] PULONG  Filled
);

Параметры

[in] Start

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

[in] Size

Указывает количество байтов для записи в память целевого объекта.

[in] Pattern

Указывает расположение памяти шаблона.

[in] PatternSize

Задает размер шаблона в байтах.

[out, optional] Filled

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

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

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

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

Замечания

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

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