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

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

Syntax

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

Parameters

Destination

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

Source

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

Length

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

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

None

Remarks

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

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

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

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

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

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

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

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

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

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

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

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

Requirements

См. также

CopyFromUserNonTemporal

CopyFromMode

CopyToUser

CopyFromUserAligned