Поделиться через


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

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

Syntax

VOID WriteUShortToUser(
  volatile USHORT *Destination,
  USHORT          Value
);

Parameters

Destination

[out] Указатель на расположение памяти в пользовательском режиме, где будет записано значение USHORT.

Value

[in] Значение USHORT для записи в расположение целевой памяти.

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

None

Remarks

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

Эта функция не применяет выравнивание.

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

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

Эта функция работает во всех версиях Windows, а не только на последних версиях. Чтобы получить объявление функции из заголовка usermode_accessors.h , необходимо использовать последнюю версию WDK. Вам также нужна библиотека (umaccess.lib) из последней версии WDK. Однако результирующий драйвер будет работать в более ранних версиях Windows.

Requirements

Requirement Value
Минимальный поддерживаемый клиент См. примечания
Header usermode_accessors.h
Library umaccess.lib
IRQL Меньше или равно APC_LEVEL

См. также

ReadUShortFromUser

WriteUShortToMode