> ## 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](/zh-TW/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](/zh-TW/reference/system/xmem/functions/xmemallocatephysicalpages) 函式所配置的實體頁面。釋放的頁面可能少於 `NumberOfPages` 中所要求的數目。如果函式傳回 `FALSE`，請檢查 `NumberOfPages` 中傳回的值，以查看實際釋放了多少頁面。如需使用實體頁面的詳細資訊，請參閱[使用 Microsoft GDK 遊戲 OS 記憶體管理員](/zh-TW/build/console-features/memory/system-memory-working)。

<a id="requirementsSection" />

## 需求

**標頭：** xmem.h

**程式庫：** xmem.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

<a id="seealsoSection" />

## 另請參閱

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


## Related topics

- [XMemFreePhysicalPages](/reference/system/xmem/functions/xmemfreephysicalpages.md)
- [XMemMapPhysicalPages](/reference/system/xmem/functions/xmemmapphysicalpages.md)