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

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

Syntax

VOID CopyToUserFromUser(
  volatile VOID       *Destination,
  volatile const VOID *Source,
  SIZE_T              Length
);

Parameters

Destination

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

Source

[in] Указатель на расположение памяти в пользовательском режиме, из которого копируются данные.

Length

[in] Количество байтов для копирования.

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

None

Remarks

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

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

• Функция выполняет переменную копию с помощью семантики memory_order_relaxed.

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

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

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

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

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

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

Если вы копируете структуру фиксированного размера, вместо этого следует использовать WriteStructToUser , чтобы избежать риска передачи неправильного размера.

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

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

Requirements

См. также

CopyToUser

CopyFromUser

MoveToUserFromUser