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

Статья
04/21/2023

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

Синтаксис

NTSTATUS MmCopyMemory(
  [in]  PVOID           TargetAddress,
  [in]  MM_COPY_ADDRESS SourceAddress,
  [in]  SIZE_T          NumberOfBytes,
  [in]  ULONG           Flags,
  [out] PSIZE_T         NumberOfBytesTransferred
);

Параметры

[in] TargetAddress

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

[in] SourceAddress

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

[in] NumberOfBytes

Число байтов для копирования из SourceAddress в TargetAddress.

[in] Flags

Флаги, указывающие, является ли SourceAddress виртуальным или физическим адресом. Для этого параметра определены следующие биты флагов.

Бит флага	Описание
MM_COPY_MEMORY_PHYSICAL	SourceAddress указывает физический адрес.
MM_COPY_MEMORY_VIRTUAL	SourceAddress указывает виртуальный адрес.

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

[out] NumberOfBytesTransferred

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

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

MmCopyMemory возвращает STATUS_SUCCESS, если весь диапазон успешно скопирован. В противном случае возвращается состояние ошибки, и вызывающий объект должен проверить выходное значение, на которое указывает параметр NumberOfBytesTransferred , чтобы определить, сколько байтов было скопировано на самом деле.

Если установлен флаг MM_COPY_MEMORY_PHYSICAL, SourceAddress должен указывать на обычную память, которая находится под управлением операционной системы. MmCopyMemory возвращает код состояния ошибки для физических адресов, которые ссылаются на пространство ввода-вывода, в том числе подключенные к памяти устройства и таблицы встроенного ПО. Для доступа к физической памяти в пространстве ввода-вывода драйверы могут использовать подпрограмму MmMapIoSpace .

Если установлен флаг MM_COPY_MEMORY_VIRTUAL, SourceAddress может указывать либо на буфер в системном адресном пространстве, либо на буфер в адресном пространстве пользователя текущего процесса. Если вызывающий объект не контролирует время существования выделения, содержащего указанный исходный адрес, MmCopyMemory может завершиться ошибкой или возвратить несогласованные данные, но не приведет к сбою системы даже для системных адресов, которые являются недопустимыми и вызовут ошибку проверка при прямой ссылке. MmCopyMemory возвращает код состояния ошибки для виртуальных системных адресов, которые ссылаются на пространство ввода-вывода.

Если память по виртуальному адресу, указанному в SourceAddress , не является резидентной, MmCopyMemory попытается сделать ее резидентной.

Требования

Требование	Значение
Минимальная версия клиента	Доступно, начиная с Windows 8.1.
Целевая платформа	Универсальное
Верхняя часть	ntddk.h
Библиотека	Ntoskrnl.lib
IRQL	<= APC_LEVEL

См. также раздел

MM_COPY_ADDRESS

MmMapIoSpace

Поделиться через