Макрос ReadStructFromUserAligned (usermode_accessors.h)

Макрос ReadStructFromUserAligned безопасно считывает структуру из памяти пользовательского режима с проверкой выравнивания.

Syntax

void ReadStructFromUserAligned(
  Destination,
  Source,
  Alignment
);

Parameters

Destination

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

Source

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

Alignment

[in] Необходимое выравнивание исходного адреса в байтах.

Return value

None

Remarks

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

Макрос проверяет, что точка источника и назначения совместима с типами и автоматически определяет размер структуры для операции копирования.

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

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

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

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

Requirements

See also

ReadStructFromUser

ReadStructFromModeAligned

ReadStructFromUserHelper

WriteStructToUserAligned