VirtualAllocExNuma 函数 (memoryapi.h)

  • 项目

保留、提交或更改指定进程的虚拟地址空间中的内存区域的状态，并为物理内存指定 NUMA 节点。

语法

LPVOID VirtualAllocExNuma(
  [in]           HANDLE hProcess,
  [in, optional] LPVOID lpAddress,
  [in]           SIZE_T dwSize,
  [in]           DWORD  flAllocationType,
  [in]           DWORD  flProtect,
  [in]           DWORD  nndPreferred
);

parameters

[in] hProcess

进程的句柄。 函数在此进程的虚拟地址空间内分配内存。

句柄必须具有 PROCESS_VM_OPERATION 访问权限。 有关详细信息，请参阅 进程安全性和访问权限。

[in, optional] lpAddress

为要分配的页面区域指定所需起始地址的指针。

如果要保留内存，函数会将此地址向下舍入到分配粒度的最近倍数。

如果提交已保留的内存，函数会将此地址向下舍入到最近的页边界。 若要确定页面的大小和主计算机上的分配粒度，请使用 GetSystemInfo 函数。

如果 lpAddress 为 NULL，则该函数确定分配区域的位置。

[in] dwSize

要分配的内存区域的大小（以字节为单位）。

如果 lpAddress 为 NULL，则该函数会将 dwSize 向上舍入到下一页边界。

如果 lpAddress 不为 NULL，则该函数会将包含一个或多个字节的所有页面分配在 从 lpAddress 到 (lpAddress+dwSize)的范围内。 例如，这意味着跨页边界的 2 字节范围会导致函数分配这两个页面。

[in] flAllocationType

内存分配的类型。 此参数必须包含以下值之一。

值 含义
MEM_COMMIT
0x00001000
 从指定保留内存页的磁盘) 的总内存大小和分页文件 (分配内存费用。 函数还保证当调用方稍后最初访问内存时，内容将为零。 除非实际访问虚拟地址，否则不会分配实际物理页面。

若要在一个步骤中保留和提交页面，请使用 MEM_COMMIT | MEM_RESERVE调用 函数。

尝试通过指定 MEM_COMMIT 而不指定 MEM_RESERVE 和非 NULLlpAddress 来提交特定地址范围，除非已保留整个范围。 生成的错误代码ERROR_INVALID_ADDRESS。

尝试提交已提交的页面不会导致函数失败。 这意味着，无需先确定每个页面的当前承诺状态即可提交页面。
MEM_RESERVE
0x00002000
 保留进程的虚拟地址空间范围，而无需在内存或磁盘上的分页文件中分配任何实际物理存储。

通过使用 MEM_COMMIT 再次调用 函数来提交保留页。 若要在一个步骤中保留和提交页面，请使用 MEM_COMMIT | MEM_RESERVE调用 函数。

其他内存分配函数（如 malloc 和 LocalAlloc）在释放内存之前不能使用预留内存。
MEM_RESET
0x00080000
 指示 lpAddress 和 dwSize 指定的内存范围中的数据不再感兴趣。 不应从分页文件读取或写入页面。 但是，内存块稍后将再次使用，因此不应取消提交。 此值不能与任何其他值一起使用。

使用此值并不能保证使用 MEM_RESET 操作的范围将包含零。 如果希望范围包含零，请取消提交内存，然后重新提交。

使用 MEM_RESET 时，函数会忽略 fProtect 的值。 但是，仍必须将 fProtect 设置为有效的保护值，例如 PAGE_NOACCESS。

如果使用 MEM_RESET 并且内存范围映射到文件，则函数将返回错误。 仅当共享视图映射到分页文件时，才可接受该视图。
MEM_RESET_UNDO
0x1000000
 应 仅对之前成功应用MEM_RESET的地址范围调用 MEM_RESET_UNDO 。 它指示调用方对 lpAddress 和 dwSize 指定的指定内存范围中的数据感兴趣，并尝试反转 MEM_RESET的影响。 如果该函数成功，则表示指定地址范围中的所有数据都保持不变。 如果函数失败，则至少将地址范围中的某些数据替换为零。

此值不能与任何其他值一起使用。 如果在之前未MEM_RESET的地址范围上调用MEM_RESET_UNDO，则行为未定义。 指定 MEM_RESET时， VirtualAllocExNuma 函数将忽略 flProtect 的值。 但是，仍必须将 flProtect 设置为有效的保护值，例如 PAGE_NOACCESS。

Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista： 在 Windows 8 和 Windows Server 2012 之前，不支持 MEM_RESET_UNDO 标志。
 

此参数还可以按指示指定以下值。

值 含义
MEM_LARGE_PAGES
0x20000000
 使用 大页支持分配内存。

大小和对齐方式必须是大页最小值的倍数。 若要获取此值，请使用 GetLargePageMinimum 函数。

如果指定此值，还必须指定 MEM_RESERVE 和 MEM_COMMIT。
MEM_PHYSICAL
0x00400000
 保留可用于将 地址窗口扩展 (AWE) 页映射的地址范围。

此值必须与 MEM_RESERVE 一起使用，不能与其他值一起使用。
MEM_TOP_DOWN
0x00100000
 在可能的最高地址分配内存。

[in] flProtect

要分配的页区域的内存保护。 如果正在提交页面，则可以指定任何一个 内存保护常量。

保护页面时指定的保护属性不能与分配页面时指定的属性冲突。

[in] nndPreferred

物理内存应驻留的 NUMA 节点。

仅在分配新的 VA 区域 (已提交或保留) 时才使用。 否则，当 API 用于提交已存在的区域中的页面时，将忽略此参数

返回值

如果函数成功，则返回值是已分配页区域的基址。

如果函数失败，则返回值为 NULL。 要获得更多的错误信息，请调用 GetLastError。

注解

每个页面都有一个关联的 页状态。 VirtualAllocExNuma 函数可以执行以下操作：

  • 提交保留页的区域
  • 保留可用页面区域
  • 同时保留和提交可用页面区域

VirtualAllocExNuma 无法保留保留页。 它可以提交已提交的页面。 这意味着，无论页面是否已提交，都可以提交一系列页面，并且函数不会失败。

可以使用 VirtualAllocExNuma 保留页面块，然后对 VirtualAllocExNuma 进行其他调用，以提交保留块中的单个页面。 这使进程能够保留其虚拟地址空间的范围，而无需使用物理存储，直到需要为止。

如果 lpAddress 参数不为 NULL，则该函数使用 lpAddress 和 dwSize 参数来计算要分配的页面区域。 整个页面范围的当前状态必须与 flAllocationType 参数指定的分配类型兼容。 否则，函数将失败，并且不会分配任何页面。 此兼容性要求不排除提交已提交的页面;请参阅前面的列表。

由于 VirtualAllocExNuma 不分配任何物理页面，因此无论页面在该节点上或系统中的其他位置上是否可用，它都会成功。 物理页面是按需分配的。 如果首选节点的页数不足，内存管理器将使用其他节点中的页。 如果内存已分页，则返回内存时会使用相同的进程。

若要执行动态生成的代码，请使用 VirtualAllocExNuma 分配内存，并使用 VirtualProtectEx 函数授予 PAGE_EXECUTE 访问权限。

VirtualAllocExNuma 函数可用于在指定进程的虚拟地址空间中保留地址窗口扩展 (AWE) 内存区域。 然后，可以使用此内存区域将物理页映射到虚拟内存中，以及根据应用程序的要求映射出虚拟内存。 必须在 AllocationType 参数中设置MEM_PHYSICAL和MEM_RESERVE值。 不得设置 MEM_COMMIT 值。 页面保护必须设置为 PAGE_READWRITE。

VirtualFreeEx 函数可以取消提交已提交的页面、释放页面的存储，也可以同时取消提交和释放已提交的页面。 它还可以释放保留页，使其成为免费页面。

若要编译使用此函数的应用程序， 请将_WIN32_WINNT 定义为 0x0600 或更高版本。

示例

有关示例，请参阅 从 NUMA 节点分配内存。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 memoryapi.h (包括 Windows.h、Memoryapi.h)
Library onecore.lib
DLL Kernel32.dll

另请参阅

内存管理函数

NUMA 支持

虚拟内存函数

VirtualAllocEx

VirtualFreeEx

VirtualLock

VirtualProtect

VirtualQuery