Функция NtFreeVirtualMemory (ntifs.h)

NtFreeVirtualMemory стандартных выпусках, вывода из эксплуатации или выпусках и выводах, регион страниц в виртуальном адресном пространстве указанного процесса.

Синтаксис

__kernel_entry NTSYSCALLAPI NTSTATUS NtFreeVirtualMemory(
  [in]      HANDLE  ProcessHandle,
  [in, out] PVOID   *BaseAddress,
  [in, out] PSIZE_T RegionSize,
  [in]      ULONG   FreeType
);

Параметры

[in] ProcessHandle

Дескриптор процесса, в контексте которого страницы будут освобождены. Используйте макрос NtCurrentProcess, определенный в ntddk.h, чтобы указать текущий процесс.

[in, out] BaseAddress

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

Если флаг MEM_RELEASE задан в параметре FreeType, *BaseAddress должен быть базовым адресом, возвращаемым NtAllocateVirtualMemory при зарезервировании региона.

[in, out] RegionSize

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

Если флаг MEM_RELEASE задан в *FreeType, *RegionSize должно быть равно нулю. NtFreeVirtualMemory освобождает весь регион, зарезервированный в первоначальном вызове выделения NtAllocateVirtualMemory.

Если флаг MEM_DECOMMIT задан в *FreeType, NtFreeVirtualMemory выводит из эксплуатации все страницы памяти, содержащие один или несколько байтов в диапазоне от *BaseAddress до (*BaseAddress + *RegionSize). Это означает, например, что если область памяти двухбайтовой области памяти привязана к границе страницы, обе страницы удаляются.

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

• Установлен флаг MEM_DECOMMIT.
• *BaseAddress — это базовый адрес, возвращаемый NtAllocateVirtualMemory при зарезервировании региона.
• *RegionSize равно нулю.

[in] FreeType

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

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

NtFreeVirtualMemory возвращает STATUS_SUCCESS или код состояния ошибки. Возможные коды состояния ошибок включают следующие.

Замечания

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

NtFreeVirtualMemory могут выполнять следующие операции:

• Отмените фиксацию или незафиксированные страницы. После этой операции страницы находятся в зарезервированном состоянии.
• Выпустите область зарезервированных страниц. После этой операции страницы находятся в свободном состоянии.
• Отмените и отпустите регион зафиксированных или незафиксированных страниц. После этой операции страницы находятся в свободном состоянии.

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

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

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

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

Дополнительные сведения о поддержке управления памятью для драйверов в режиме ядра см. в разделе Управление памятью для драйверов Windows.

Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.

Требования

См. также

NtAllocateVirtualMemory