> ## 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.

# XMemPreallocateFreeSpace

> XMemPreallocateFreeSpace

# XMemPreallocateFreeSpace

為堆積配置可用頁面，最多至其遲滯值。

## 語法

```cpp theme={null}
BOOL XMemPreallocateFreeSpace(  
         DWORD MemType,  
         BOOL LargeHeap  
)  
```

### 參數

*MemType*   \_In\_\
類型：DWORD

描述堆積的 **XALLOC\_MEMTYPE\_GRAPHICS** 常數。如需詳細資訊，請參閱 [XALLOC\_ATTRIBUTES](https://docs.xbox.com/zh-TW/reference/system/xmem/structs/xalloc_attributes.md)。

*LargeHeap*   \_In\_\
類型：BOOL

表示堆積是否為「大型」。如果設定為 true，則堆積會被視為「大型」；否則堆積會被視為「小型」。「大型」堆積用於滿足 4 KB 到 128 KB 的配置，或對齊指定為 4 KB 或更高的配置；「小型」堆積用於滿足小於 4 KB 且對齊指定為小於 4 KB 的配置。

### 傳回值

類型：BOOL

如果可以配置所有頁面，則傳回 `TRUE`；否則傳回 `FALSE`。

## 備註

此函式會為 *MemType* 中所描述的堆積配置可用空間，最多至該堆積的遲滯量。請使用 [XMemGetAllocationHysteresis](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemgetallocationhysteresis.md) 來取得堆積的遲滯量，或使用 [XMemSetAllocationHysteresis](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemsetallocationhysteresis.md) 來指定堆積的遲滯量。如需詳細資訊，請參閱[記憶體](https://docs.xbox.com/zh-TW/build/console-features/memory/system-memory-overview.md)。

## 需求

**標頭：** xmem.h

**程式庫：** xmem.lib

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

## 另請參閱

[XALLOC\_ATTRIBUTES](https://docs.xbox.com/zh-TW/reference/system/xmem/structs/xalloc_attributes.md)\
[XMem](https://docs.xbox.com/zh-TW/reference/system/xmem/xmem_members.md)


## Related topics

- [XPersistentLocalStorageSpaceInfo](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XMemFreeDefault](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemfreedefault.md)
- [XMemFreePhysicalPages](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemfreephysicalpages.md)
- [XPersistentLocalStorageGetSpaceInfo](https://docs.xbox.com/zh-TW/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md)
- [PIXRecordMemoryFreeEvent](https://docs.xbox.com/zh-TW/reference/tools/pix3/functions/pixrecordmemoryfreeevent.md)