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

Alloue des pages libres pour un tas jusqu'à sa valeur d'hystérésis.

## Syntaxe

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

### Paramètres

*MemType*   \_In\_\
Type : DWORD

Constante **XALLOC\_MEMTYPE\_GRAPHICS** qui décrit le tas. Pour plus d'informations, consultez [XALLOC\_ATTRIBUTES](https://docs.xbox.com/fr/reference/system/xmem/structs/xalloc_attributes.md).

*LargeHeap*   \_In\_\
Type : BOOL

Indique si le tas est « grand ». Si la valeur est true, le tas est considéré comme « grand » ; sinon, il est considéré comme « petit ». Les « grands » tas sont utilisés pour satisfaire les allocations comprises entre 4 Ko et 128 Ko, ou dont l'alignement spécifié est de 4 Ko ou plus ; les « petits » tas sont utilisés pour satisfaire les allocations inférieures à 4 Ko dont l'alignement spécifié est inférieur à 4 Ko.

### Valeur renvoyée

Type : BOOL

Renvoie `TRUE` si toutes les pages ont pu être allouées ; sinon, `FALSE`.

## Remarques

Cette fonction alloue de l'espace libre pour le tas décrit dans *MemType*, jusqu'à la valeur d'hystérésis de ce tas. Utilisez [XMemGetAllocationHysteresis](https://docs.xbox.com/fr/reference/system/xmem/functions/xmemgetallocationhysteresis.md) pour obtenir la valeur d'hystérésis d'un tas, ou [XMemSetAllocationHysteresis](https://docs.xbox.com/fr/reference/system/xmem/functions/xmemsetallocationhysteresis.md) pour spécifier la valeur d'hystérésis d'un tas. Pour plus d'informations, consultez [Mémoire](https://docs.xbox.com/fr/build/console-features/memory/system-memory-overview.md).

## Configuration requise

**En-tête :** xmem.h

**Bibliothèque :** xmem.lib

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

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


## Related topics

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