Функция ReclaimVirtualMemory (memoryapi.h)

Статья
08/24/2023

Освобождает диапазон страниц памяти, которые были предложены системе с помощью OfferVirtualMemory.

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

Синтаксис

DWORD ReclaimVirtualMemory(
  [in] void const *VirtualAddress,
  [in] SIZE_T     Size
);

Параметры

[in] VirtualAddress

Выровненный по страницам начальный адрес памяти для восстановления.

[in] Size

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

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

Возвращает ERROR_SUCCESS, если память была восстановлена без изменений.

Возвращает ERROR_BUSY в случае успешного выполнения, но память была удалена и должна быть перезаписана приложением. В этом случае содержимое области памяти не определено.

В противном случае возвращает код системной ошибки .

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1 с обновлением [классические приложения \| Приложения UWP]
Минимальная версия сервера	обновление Windows Server 2012 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	memoryapi.h (включая Windows.h, Memoryapi.h)
Библиотека	onecore.lib
DLL	Kernel32.dll