AllocateUserPhysicalPagesNuma 函数 (memoryapi.h)
在指定进程的 AWE) 区域中分配要映射和取消映射的任何 地址窗口扩展 (物理内存页，并为物理内存指定 NUMA 节点。
语法
BOOL AllocateUserPhysicalPagesNuma(
[in] HANDLE hProcess,
[in, out] PULONG_PTR NumberOfPages,
[out] PULONG_PTR PageArray,
[in] DWORD nndPreferred
);
parameters
[in] hProcess
进程的句柄。
函数分配稍后可以在此进程的虚拟地址空间中映射的内存。 句柄必须具有 PROCESS_VM_OPERATION 访问权限。 有关详细信息，请参阅 进程安全和访问权限。
[in, out] NumberOfPages
要分配的物理内存的大小（以页为单位）。
若要确定计算机的页面大小，请使用 GetSystemInfo 函数。 输出时，此参数接收实际分配的页数，可能小于请求的数目。
[out] PageArray
指向数组的指针，用于存储已分配内存的页帧编号。
分配的数组的大小应至少为 NumberOfPages 乘 以ULONG_PTR 数据类型的大小。
[in] nndPreferred
物理内存应驻留的 NUMA 节点。
返回值
如果函数成功，则返回值为 TRUE。
可分配的页数少于请求的页数。 调用方必须在返回时检查 NumberOfPages 参数的值，以查看分配了多少页。 所有分配的页面帧编号都按顺序放置在 PageArray 参数指向的内存中。
如果函数失败，则返回值为 FALSE ，并且不分配任何帧。 若要获得更多的错误信息，请调用 GetLastError 函数。
注解
AllocateUserPhysicalPagesNuma 函数用于在 NUMA 节点内分配物理内存，该内存稍后可在进程的虚拟地址空间中映射。 必须在调用方令牌中启用 SeLockMemoryPrivilege 特权，否则函数将失败并 出现ERROR_PRIVILEGE_NOT_HELD。 有关详细信息，请参阅特权常量。
此函数分配的内存必须实际存在于系统中。 分配内存后，它将锁定，并且无法用于虚拟内存管理系统的其余部分。
物理页不能同时映射到多个虚拟地址。
物理页可以驻留在任何物理地址。 不应假设物理页面的连续性。
若要编译使用此函数的应用程序， 请将_WIN32_WINNT 定义为 0x0600 或更高版本。
要求
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | memoryapi.h (包括 Windows.h、Memoryapi.h) |
| Library | onecore.lib |
| DLL | Kernel32.dll |