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

The ReadUnicodeStringFromUser function safely reads a UNICODE_STRING structure from user-mode memory.

Syntax

UNICODE_STRING ReadUnicodeStringFromUser(
  const volatile UNICODE_STRING *Source
);

Parameters

Source

[in] A pointer to the user-mode memory location from which to read the UNICODE_STRING structure.

Return value

ReadUnicodeStringFromUser returns the UNICODE_STRING structure read from the specified user-mode memory address.

Remarks

This function provides a safe way to read a UNICODE_STRING structure from user-mode memory. Он гарантирует, что указанный адрес является адресом пользовательского режима перед чтением.

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

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

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

Эта функция работает во всех версиях 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

ReadUnicodeStringFromMode

WriteUnicodeStringToUser