Функция FillModeMemory (usermode_accessors.h)

The FillModeMemory function fills a memory region with a specified byte value, based on the specified processor mode.

Syntax

VOID FillModeMemory(
  volatile VOID   *Destination,
  SIZE_T          Length,
  UCHAR           Fill,
  KPROCESSOR_MODE Mode
);

Parameters

Destination

[out] Указатель на начальный адрес блока памяти для заполнения.

Length

[in] The number of bytes to fill with the Fill value.

Fill

[in] The byte value used to fill the first Length bytes of Destination.

Mode

[in] Режим процессора, определяющий, как выполняется доступ к памяти. Mode can be one of the following values.

Return value

None

Remarks

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

Эта функция имеет следующие свойства:

• When Mode is KernelMode, the function performs a direct memory fill without additional safety checks.

• When Mode is UserMode, the function validates the pointer is a user-mode address and then performs the fill. The memory access is performed with memory_order_relaxed semantics.

• Эта функция не распознается как компилятор instrinsic, поэтому компилятор никогда не оптимизирует вызов (полностью или замените вызов эквивалентной последовательностью инструкций).

• When the call returns, the first Length bytes of the buffer have been overwritten with the specified Fill value. This function's memory accesses to the Destination will only be performed within the function (for example, the compiler can't move memory accesses out of this function).

• Функция может выполнять неуправляемый доступ к памяти, если платформа позволяет ей.

• Функция может получить доступ к расположениям памяти более одного раза в рамках операции заполнения.

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

Эта функция работает во всех версиях Windows, а не только на последних версиях. You need to consume the latest WDK to get the function declaration from the usermode_accessors.h header. You also need the library (umaccess.lib) from the latest WDK. Однако результирующий драйвер будет работать в более ранних версиях Windows.

Requirements

See also

FillUserMemory

SetModeMemory

ZeroModeMemory

CopyToMode