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

# XMemFreePhysicalPages

> XMemFreePhysicalPages

# XMemFreePhysicalPages

將使用 [XMemAllocatePhysicalPages](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemallocatephysicalpages.md) 配置的頁面釋放回記憶體管理員。

## 語法

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

### 參數

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

要釋放的實體記憶體頁面數目。

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

指向要釋放之已配置記憶體的頁框編號陣列的指標。

### 傳回值

類型：BOOL

如果函式釋放了 *NumberOfPages* 中指定的頁面數目，則傳回值為 `TRUE`；否則函式會傳回 `FALSE`，且 *NumberOfPages* 會設定為實際釋放的頁面數目。若要取得延伸錯誤資訊，請呼叫 [GetLastError](https://msdn.microsoft.com/library/windows/desktop/ms679360\(v=vs.85\).aspx)。

## 備註

使用此函式來釋放先前透過呼叫 [XMemAllocatePhysicalPages](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemallocatephysicalpages.md) 函式所配置的實體頁面。釋放的頁面可能少於 `NumberOfPages` 中所要求的數目。如果函式傳回 `FALSE`，請檢查 `NumberOfPages` 中傳回的值，以查看實際釋放了多少頁面。如需使用實體頁面的詳細資訊，請參閱[使用 Microsoft GDK 遊戲 OS 記憶體管理員](https://docs.xbox.com/zh-TW/build/console-features/memory/system-memory-working.md)。

## 需求

**標頭：** xmem.h

**程式庫：** xmem.lib

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

## 另請參閱

[XMemAllocatePhysicalPages](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemallocatephysicalpages.md)\
[XMem](https://docs.xbox.com/zh-TW/reference/system/xmem/xmem_members.md)


## Related topics

- [XMemMapPhysicalPages](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemmapphysicalpages.md)
- [使用 Microsoft GDK Game OS 記憶體管理員](https://docs.xbox.com/zh-TW/build/console-features/memory/system-memory-working.md)
- [XMemMapPhysicalPagesScatter](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemmapphysicalpagesscatter.md)
- [XMemFreeDefault](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemfreedefault.md)
- [DSTORAGE_REQUEST_OPTIONS](https://docs.xbox.com/zh-TW/reference/system/dstorage/structs/dstorage_request_options.md)