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