ZwFreeVirtualMemory 函数 (ntifs.h)

  • 项目

ZwFreeVirtualMemory 例程发布和/或取消提交指定进程的虚拟地址空间中的页面区域。

语法

NTSYSAPI NTSTATUS ZwFreeVirtualMemory(
  [in]      HANDLE  ProcessHandle,
  [in, out] PVOID   *BaseAddress,
  [in, out] PSIZE_T RegionSize,
  [in]      ULONG   FreeType
);

参数

[in] ProcessHandle

要释放的页面所在的上下文的进程句柄。 使用 Ntddk.h 中定义的 NtCurrentProcess 宏指定当前进程。

[in, out] BaseAddress

指向变量的指针，该变量将接收页面释放区域的虚拟地址。

如果在 FreeType 参数中设置了 MEM_RELEASE 标志， 则 BaseAddress 必须是 ZwAllocateVirtualMemory 在保留区域时返回的基址。

[in, out] RegionSize

指向变量的指针，该变量将接收页面释放区域的实际大小（以字节为单位）。 例程将此变量的初始值舍入到下一个主机页大小边界，并将舍入值写回此变量。

如果在 FreeType 参数中设置了MEM_RELEASE标志， 则 RegionSize 指向的变量必须为零。 ZwFreeVirtualMemory 释放在对 ZwAllocateVirtualMemory 的初始分配调用中保留的整个区域。

如果在 FreeType 参数中设置了MEM_DECOMMIT标志， 则 ZwFreeVirtualMemory 将取消提交包含一个或多个字节的所有内存页，该范围从 BaseAddress 参数到 (BaseAddress + RegionSize) 。 这意味着，例如，如果内存的两字节区域跨页边界，则两个页面都将取消提交。

ZwFreeVirtualMemory 取消提交 ZwAllocateVirtualMemory 保留的整个区域。 如果满足以下三个条件，则整个区域将进入保留状态：

  • 设置MEM_DECOMMIT标志。
  • BaseAddress 是 ZwAllocateVirtualMemory 在保留区域时返回的基址。
  • RegionSize< 为零。

[in] FreeType

一个位掩码，其中包含描述 ZwFreeVirtualMemory 将针对指定页面区域执行的自由操作类型的标志。 可能的值如下：

  • MEM_DECOMMIT

    • ZwFreeVirtualMemory 将取消提交指定的页面区域。 页面进入保留状态。

    • 如果尝试取消提交未提交的页面，ZwFreeVirtualMemory 不会失败。 这意味着可以取消提交一系列页面，而无需先确定页面的当前承诺状态。

  • MEM_RELEASE

    ZwFreeVirtualMemory 将释放页面的指定区域。 页面进入空闲状态。

    如果指定此标志， 则 RegionSize 指向的变量必须为零， BaseAddress 必须指向保留区域时 ZwAllocateVirtualMemory 返回的基址。 如果未满足上述任一条件，ZwFreeVirtualMemory 将失败。

    如果当前已提交区域中的任何页面， 则 ZwFreeVirtualMemory 先取消提交，然后释放它们。

如果尝试释放处于不同状态（一些保留和一些已提交）的页面，ZwFreeVirtualMemory 不会失败。 这意味着，无需先确定页面的当前承诺状态即可发布一系列页面。

返回值

ZwFreeVirtualMemory 返回STATUS_SUCCESS或错误状态代码。 可能的错误状态代码包括以下内容。

返回代码 说明
STATUS_ACCESS_DENIED 进程已请求访问对象，但尚未被授予这些访问权限。
STATUS_INVALID_HANDLE 指定了无效 的 ProcessHandle 值。
STATUS_OBJECT_TYPE_MISMATCH 请求的操作所需的对象类型与请求中指定的对象类型不匹配。

注解

进程虚拟地址空间中的每个页面都处于三种状态之一，如下所述。

  • 状态为免费

    页面既不提交也不保留。 进程无法访问该页面。 尝试从免费页面读取或写入会导致访问冲突异常。

    可以使用 ZwFreeVirtualMemory 将保留或提交的页面置于免费状态。

  • 状态为 RESERVED

    该页是保留的。 地址范围不能由其他分配函数使用。 进程无法访问该页，并且没有与之关联的物理存储。 尝试从保留页读取或写入会导致访问冲突异常。

    可以使用 ZwFreeVirtualMemory 将提交的内存页置于保留状态，并将预留内存页置于可用状态。

  • 状态为 COMMITTED

    已提交页面。 内存中或磁盘上分页文件中的物理存储为页面分配，访问由保护代码控制。

    系统仅在第一次尝试从该页读取或写入该页时，初始化每个提交的页面并将其加载到物理内存中。

    当进程终止时，系统会释放已提交页面的所有存储。

    可以使用 ZwAllocateVirtualMemory 将提交的内存页置于保留或可用状态。

ZwFreeVirtualMemory 可以执行以下操作：

  • 取消提交包含已提交或未提交的页面的区域。 此操作后，页面将处于保留状态。
  • 释放保留页的区域。 在执行该操作之后，这些页面将处于可用状态。
  • 取消提交并释放包含已提交或未提交的页面的区域。 在执行该操作之后，这些页面将处于可用状态。

ZwFreeVirtualMemory 可以取消提交处于不同状态（一些已提交和一些未提交）的一系列页面。 这意味着，无需先确定每个页面的当前承诺状态，即可取消提交一系列页面。 取消提交页面会释放其物理存储，无论是在内存中还是在磁盘上的分页文件中。

如果页面已取消提交但未释放，则其状态将更改为“保留”。 随后可以调用 ZwFreeVirtualMemory 来提交它，或 调用 ZwFreeVirtualMemory 来释放它。 尝试从保留页读取或写入会导致访问冲突异常。

ZwFreeVirtualMemory 可以发布处于不同状态（一些保留和一些已提交）的一系列页面。 这意味着，无需首先确定每个页面的当前承诺状态，即可发布一系列页面。 最初由 ZwAllocateVirtualMemory 保留的整个页面范围必须同时发布。

如果发布页面，则其状态将更改为“释放”，并且可用于后续的分配操作。 释放或取消提交内存后，再也不能引用内存。 该内存中可能已存在的任何信息将永久消失。 尝试从免费页面读取或写入会导致访问冲突异常。 如果需要信息，请不要弃用或释放包含该信息的内存。

有关内核模式驱动程序的内存管理支持的详细信息，请参阅 Windows 驱动程序的内存管理。

注意

如果在用户模式下调用 ZwFreeVirtualMemory 函数，则应使用名称“NtFreeVirtualMemory”而不是“ZwFreeVirtualMemory”。

对于来自内核模式驱动程序的调用，Windows 本机系统服务例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息，请参阅 使用本机系统服务例程的 Nt 和 Zw 版本。

要求

要求 值
最低受支持的客户端 Windows 2000
目标平台 通用
标头 ntifs.h (包括 Ntifs.h、Fltkernel.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI (storport) 、 PowerIrpDDis (wdm)

另请参阅

ZwAllocateVirtualMemory