| 术语 | allocateuserphysicalpagesnuma |
| 释义 | AllocateUserPhysicalPagesNuma 语法： C++ BOOL WINAPI AllocateUserPhysicalPagesNuma( __in HANDLE hProcess, __inout PULONG_PTR NumberOfPages, __out PULONG_PTR PageArray, __in DWORD nndPreferred ); AllocateUserPhysicalPagesNuma功能 分配物理内存页被映射和在任何映射的地址窗口扩展(AWE)的指明工序区域，并指定为物理内存的NUMA节点。 参数 hProcess [in] 句柄的进程。 函数分配内存，以后可以在这一进程的虚拟地址空间映射。句柄必须有PROCESS_VM_OPERATION访问权。有关更多信息，请参见过程的安全性和访问权限。 NumberOfPages [ in , out ] 的物理内存大小分配，在页。 要确定计算机的页面大小，使用的GetSystemInfo函数。对产出，该参数接收的，实际的分配，这可能是数少于要求的页数。 PageArray [out] 对一个数组的指针来存储分配的内存页面帧编号。 的是分配的数组的大小应至少NumberOfPages倍的ULONG_PTR数据类型的大小。 注意不要试图修改此缓冲区。它包含操作系统数据，以及腐败将会是灾难性的。缓冲区中的信息是没有用的应用程序。 nndPreferred [in] 在NUMA节点在物理内存应该驻留。 返回值 如果函数成功，返回值为TRUE。 不到请求的页面可以分配。调用者必须检查返回的NumberOfPages参数的值，看看有多少页均分配。所有分配的页面帧编号按顺序放置在内存中指出，由PageArray参数。 如果函数失败，返回值为FALSE，并没有帧分配。为了获得更多错误信息，调用GetLastError函数。 备注 该AllocateUserPhysicalPagesNuma函数用于分配NUMA节点内，以后可以在进程的虚拟地址空间映射到物理内存。该SeLockMemoryPrivilege特权必须启用呼叫方的令牌或函数将失败，ERROR_PRIVILEGE_NOT_HELD。有关更多信息，请参阅权限常量。 这个函数分配的内存必须实际存在于该系统。后分配内存，将被锁定和不可用的虚拟内存管理系统的其余部分。 物理页不能同时映射在多个虚拟地址。 物理页可以驻留在任何物理地址。您应该对物理页毗连的任何假设。 要编译的应用程序使用此功能，定义_WIN32_WINNT为0x0600或更高版本。 要求： client最低支持Vista server最低支持 Windows Server 2008 HeaderWinbase.h(头文件：winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 地址窗口扩展 AllocateUserPhysicalPages FreeUserPhysicalPages 内存管理功能 NUMA支持 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年8月27日 ＝＝英文原文＝＝AllocateUserPhysicalPagesNuma Function Allocates physical memory pages to be mapped and unmapped within any Address Windowing Extensions (AWE) region of a specified process and specifies the NUMA node for the physical memory. Syntax C++ BOOL WINAPI AllocateUserPhysicalPagesNuma( __in HANDLE hProcess, __inout PULONG_PTR NumberOfPages, __out PULONG_PTR PageArray, __in DWORD nndPreferred ); Parameters hProcess [in] A handle to a process. The function allocates memory that can later be mapped within the virtual address space of this process. The handle must have the PROCESS_VM_OPERATION access right. For more information, see Process Security and Access Rights . NumberOfPages [in, out] The size of the physical memory to allocate, in pages. To determine the page size of the computer, use the GetSystemInfo function. On output, this parameter receives the number of pages that are actually allocated, which might be less than the number requested. PageArray [out] A pointer to an array to store the page frame numbers of the allocated memory. The size of the array that is allocated should be at least the NumberOfPages times the size of the ULONG_PTR data type. Caution Do not attempt to modify this buffer. It contains operating system data, and corruption could be catastrophic. The information in the buffer is not useful to an application. nndPreferred [in] The NUMA node where the physical memory should reside. Return Value If the function succeeds, the return value is TRUE. Fewer pages than requested can be allocated. The caller must check the value of the NumberOfPages parameter on return to see how many pages are allocated. All allocated page frame numbers are sequentially placed in the memory pointed to by the PageArray parameter. If the function fails, the return value is FALSE and no frames are allocated. To get extended error information, call the GetLastError function. Remarks The AllocateUserPhysicalPagesNuma function is used to allocate physical memory within a NUMA node that can later be mapped within the virtual address space of the process. The SeLockMemoryPrivilege privilege must be enabled in the caller's token or the function will fail with ERROR_PRIVILEGE_NOT_HELD. For more information, see Privilege Constants . Memory allocated by this function must be physically present in the system. After the memory is allocated, it is locked down and unavailable to the rest of the virtual memory management system. Physical pages cannot be simultaneously mapped at more than one virtual address. Physical pages can reside at any physical address. You should make no assumptions about the contiguity of the physical pages. To compile an application that uses this function, define _WIN32_WINNT as 0x0600 or later. Requirements Minimum supported clientWindows Vista Minimum supported serverWindows Server 2008 HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also Address Windowing Extensions AllocateUserPhysicalPages FreeUserPhysicalPages Memory Management Functions NUMA Support Send comments about this topic to Microsoft Build date: 8/27/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/aa366529(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。