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

The FillUserMemory function fills a user-mode memory region with a specified byte value.

Syntax

VOID FillUserMemory(
  volatile VOID *Destination,
  SIZE_T        Length,
  UCHAR         Fill
);

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.

Return value

None

Remarks

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

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

• The function performs a fill using memory_order_relaxed semantics.

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

• When the call returns, the buffer has 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

FillModeMemory

SetUserMemory

ZeroUserMemory

CopyToUser