Функция RtlWriteNonVolatileMemory (ntddk.h)

Статья
02/07/2025

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

Синтаксис

NTSYSAPI NTSTATUS RtlWriteNonVolatileMemory(
  PVOID      NvToken,
  VOID       *NvDestination,
  const VOID *Source,
  SIZE_T     Size,
  ULONG      Flags
);

Параметры

NvToken

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

NvDestination

Указатель на неизменяемый буфер назначения для копирования.

Source

Указатель на исходный буфер для копирования.

Size

Длина операции копирования в байтах.

Flags

Зарезервировано для дальнейшего использования.

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

Подпрограмма RtlWriteNonVolatileMemory возвращает одно из следующих элементов:

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER	NvToken является недопустимым указателем или маркером.
STATUS_SUCCESS	Запрос выполнен успешно.

Замечания

Это RtlCopyMemory эквивалентно для ненезависимой памяти, добавляемой значение только с включенным проверятелем. Если средство проверки включено, диапазоны, которые изменяются, можно отслеживать в NvToken и можно сообщать в RtlFreeNonVolatileToken, если очистка не вызывается для записи. Эта подпрограмма в настоящее время не поддерживается для Windows Server до следующего основного выпуска Windows Server.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1703
минимальный поддерживаемый сервер	Не поддерживается
целевая платформа	Виндоус
заголовка	ntddk.h (include Winnt.h)