AllocateUserPhysicalPages2 函数 (memoryapi.h)

项目
12/14/2023

分配物理内存页，以在指定进程的任意地址窗口扩展 (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