术语 | freeuserphysicalpages |
释义 | FreeUserPhysicalPages 语法: C++ BOOL WINAPI FreeUserPhysicalPages( __in HANDLE hProcess, __inout PULONG_PTR NumberOfPages, __in PULONG_PTR UserPfnArray ); FreeUserPhysicalPages功能 释放物理内存分配使用AllocateUserPhysicalPages或AllocateUserPhysicalPagesNuma以前的网页。如果这些网页的任何正在映射到地址窗口扩展(AWE)的地区,它们会自动映射此调用。这不会影响的虚拟地址空间是由指定的窗口扩展(AWE)地区地址占领。 64位Itanium的Windows系统:由于在页面大小的差异,FreeUserPhysicalPages不支持32位应用程序。 参数 hProcess [in] 句柄的进程。 函数内释放这一进程的虚拟地址空间内存。 NumberOfPages [ in , out ] 的物理内存大小的自由,在页。 在返回,如果该功能失败,该参数表示的页数被释放。 UserPfnArray [in] 一个对所分配的内存页帧编号数组的指针被释放。 返回值 如果函数成功,返回值为TRUE。 如果函数失败,返回值为FALSE。在这种情况下,NumberOfPages参数反映了多少页确已被释放。为了获得更多错误信息,调用GetLastError。 备注 在多处理器环境,维护这一职能转换的硬件缓冲区的一致性。当此函数返回时,在所有的处理器保证所有的线程看到正确的映射。 要编译的应用程序使用此函数,定义为0x0500或更高_WIN32_WINNT宏。有关详细信息,请参阅使用Windows头。 实例 有关示例,请参阅awe例子。 要求: 最低支持:client-Windows 2000专业版 最低支持server-Windows 2000服务器 HeaderWinbase.h(头文件:winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 地址窗口扩展 AllocateUserPhysicalPages AllocateUserPhysicalPagesNuma MapUserPhysicalPages MapUserPhysicalPagesScatter 内存管理功能 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年8月27日 ==英文原文==FreeUserPhysicalPages Function Frees physical memory pages that are allocated previously by using AllocateUserPhysicalPages or AllocateUserPhysicalPagesNuma . If any of these pages are currently mapped in the Address Windowing Extensions (AWE) region, they are automatically unmapped by this call. This does not affect the virtual address space that is occupied by a specified Address Windowing Extensions (AWE) region. 64-bit Windows on Itanium-based systems: Due to the difference in page sizes, FreeUserPhysicalPages is not supported for 32-bit applications. Syntax C++ BOOL WINAPI FreeUserPhysicalPages( __in HANDLE hProcess, __inout PULONG_PTR NumberOfPages, __in PULONG_PTR UserPfnArray ); Parameters hProcess [in] The handle to a process. The function frees memory within the virtual address space of this process. NumberOfPages [in, out] The size of the physical memory to free, in pages. On return, if the function fails, this parameter indicates the number of pages that are freed. UserPfnArray [in] A pointer to an array of page frame numbers of the allocated memory to be freed. Return Value If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE. In this case, the NumberOfPages parameter reflect how many pages have actually been released. To get extended error information, call GetLastError . Remarks In a multiprocessor environment, this function maintains coherence of the hardware translation buffer. When this function returns, all threads on all processors are guaranteed to see the correct mapping. To compile an application that uses this function, define the _WIN32_WINNT macro as 0x0500 or later. For more information, see Using the Windows Headers . Examples For an example, see AWE Example . Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also Address Windowing Extensions AllocateUserPhysicalPages AllocateUserPhysicalPagesNuma MapUserPhysicalPages MapUserPhysicalPagesScatter Memory Management Functions Send comments about this topic to Microsoft Build date: 8/27/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa366566(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。