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

The ReadLong64FromMode function safely reads a LONG64 value from memory based on the specified processor mode.

Syntax

LONG64 ReadLong64FromMode(
  const volatile LONG64 *Source,
  KPROCESSOR_MODE       Mode
);

Parameters

Source

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

Mode

[in] Режим процессора, определяющий, как выполняется доступ к памяти. Mode can be one of the following values.

Value Meaning
KernelMode Source points to kernel-mode memory. The function performs a read from the specified address with memory_order_relaxed semantics. Дополнительные сведения см. в примечаниях.
UserMode Source points to user-mode memory. The function raises an exception if Source doesn't point to user-mode memory; otherwise it performs a read from the specified address with memory_order_relaxed semantics. Дополнительные сведения см. в примечаниях.

Return value

ReadLong64FromMode returns the LONG64 value read from the specified memory address.

Remarks

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

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

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

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

Requirement Value
Минимальный поддерживаемый клиент See Remarks
Header usermode_accessors.h
Library umaccess.lib
IRQL Меньше или равно APC_LEVEL

See also

ReadLong64FromUser

WriteLong64ToMode