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