> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XMemFreePhysicalPages

> XMemFreePhysicalPages

# XMemFreePhysicalPages

将使用 [XMemAllocatePhysicalPages](/reference/system/xmem/functions/xmemallocatephysicalpages) 分配的页释放回内存管理器。

<a id="syntaxSection" />

## 语法

```cpp theme={null}
BOOL XMemFreePhysicalPages(  
         ULONG_PTR NumberOfPages,  
         PULONG_PTR PageArray  
)  
```

<a id="parametersSection" />

### 参数

*NumberOfPages*   \_In\_\
类型：ULONG\_PTR

要释放的物理内存页数。

*PageArray*   \_In\_reads\_(NumberOfPages)\
类型：PULONG\_PTR

指向要释放的已分配内存的页帧号数组的指针。

<a id="retvalSection" />

### 返回值

类型：BOOL

如果函数释放了 *NumberOfPages* 中指定的页数，则返回值为 `TRUE`；否则函数返回 `FALSE`，并且 *NumberOfPages* 设置为实际释放的页数。若要获取扩展错误信息，请调用 <a href="https://msdn.microsoft.com/library/windows/desktop/ms679360(v=vs.85).aspx">GetLastError</a>。

<a id="remarksSection" />

## 备注

使用此函数可释放之前通过调用 [XMemAllocatePhysicalPages](/reference/system/xmem/functions/xmemallocatephysicalpages) 函数分配的物理页。释放的页数可能少于 `NumberOfPages` 中请求的页数。如果函数返回 `FALSE`，请检查 `NumberOfPages` 中返回的值以查看实际释放了多少页。有关使用物理页的更多信息，请参阅[使用 Microsoft GDK Game OS 内存管理器](/build/console-features/memory/system-memory-working)。

<a id="requirementsSection" />

## 要求

**标头：** xmem.h

**库：** xmem.lib

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

<a id="seealsoSection" />

## 请参阅

[XMemAllocatePhysicalPages](/reference/system/xmem/functions/xmemallocatephysicalpages)\
[XMem](/reference/system/xmem/xmem_members)


## Related topics

- [XMemMapPhysicalPages](/zh-CN/reference/system/xmem/functions/xmemmapphysicalpages.md)
- [使用 Microsoft GDK 游戏 OS 内存管理器](/zh-CN/build/console-features/memory/system-memory-working.md)
- [XMemMapPhysicalPagesScatter](/zh-CN/reference/system/xmem/functions/xmemmapphysicalpagesscatter.md)
- [DSTORAGE_REQUEST_OPTIONS](/zh-CN/reference/system/dstorage/structs/dstorage_request_options.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)