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

# XMemPreallocateFreeSpace

> XMemPreallocateFreeSpace

# XMemPreallocateFreeSpace

힙에 대한 이력 값까지 여유 페이지를 할당합니다.

<a id="syntaxSection" />

## 구문

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

<a id="parametersSection" />

### 매개 변수

*MemType*   \_In\_\
형식: DWORD

힙을 설명하는 **XALLOC\_MEMTYPE\_GRAPHICS** 상수입니다. 자세한 내용은 [XALLOC\_ATTRIBUTES](/reference/system/xmem/structs/xalloc_attributes)를 참조하세요.

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

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

<a id="retvalSection" />

### 반환 값

형식: BOOL

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

<a id="remarksSection" />

## 설명

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

<a id="requirementsSection" />

## 요구 사항

**헤더:** xmem.h

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

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

<a id="seealsoSection" />

## 함께 보기

[XALLOC\_ATTRIBUTES](/reference/system/xmem/structs/xalloc_attributes)\
[XMem](/reference/system/xmem/xmem_members)


## Related topics

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