> ## 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/ko/reference/system/xmem/structs/xalloc_attributes.md)를 참조하세요.

*LargeHeap*   \_In\_\
형식: BOOL

힙이 “대형”인지 여부를 나타냅니다. true로 설정하면 힙이 “대형”으로 간주됩니다. 그렇지 않으면 힙이 “소형”으로 간주됩니다. “대형” 힙은 4KB에서 128KB인 할당 또는 정렬이 4KB 이상으로 지정된 할당을 처리하는 데 사용되며, “소형” 힙은 4KB보다 작고 정렬이 4KB 미만으로 지정된 할당을 처리하는 데 사용됩니다.

### 반환 값

형식: BOOL

모든 페이지를 할당할 수 있으면 `TRUE`를 반환하고, 그렇지 않으면 `FALSE`를 반환합니다.

## 설명

이 함수는 *MemType*에 설명된 힙에 대해 해당 힙의 이력 크기까지 여유 공간을 할당합니다. 힙의 이력 크기를 가져오려면 [XMemGetAllocationHysteresis](https://docs.xbox.com/ko/reference/system/xmem/functions/xmemgetallocationhysteresis.md)를 사용하고, 힙의 이력 크기를 지정하려면 [XMemSetAllocationHysteresis](https://docs.xbox.com/ko/reference/system/xmem/functions/xmemsetallocationhysteresis.md)를 사용합니다. 자세한 내용은 [메모리](https://docs.xbox.com/ko/build/console-features/memory/system-memory-overview.md)를 참조하세요.

## 요구 사항

**헤더:** xmem.h

**라이브러리:** xmem.lib

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

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


## Related topics

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