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

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

Syntax

void WriteStructToModeAligned(
  Destination,
  Source,
  Mode,
  Alignment
);

Parameters

Destination

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

Source

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

Mode

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

Alignment

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

Return value

None

Remarks

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

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

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

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

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

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

Requirements

See also

WriteStructToMode

WriteStructToUserAligned

WriteStructToModeHelper

ReadStructFromModeAligned