AllocateUserPhysicalPages 函数 (memoryapi.h)

项目
12/14/2023

分配在指定进程的任意地址窗口扩展 (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