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

La constante **XALLOC\_MEMTYPE\_GRAPHICS** qui décrit le tas. Pour plus d'informations, consultez [XALLOC\_ATTRIBUTES](https://docs.xbox.com/fr-CA/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, le tas est considéré comme « petit ». Les « grands » tas sont utilisés pour satisfaire les allocations de 4 Ko à 128 Ko, ou dont l'alignement est spécifié à 4 Ko ou plus; et les « petits » tas sont utilisés pour satisfaire les allocations inférieures à 4 Ko et dont l'alignement est spécifié à moins de 4 Ko.

### Valeur de retour

Type : BOOL

Retourne `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-CA/reference/system/xmem/functions/xmemgetallocationhysteresis.md) pour obtenir la valeur d'hystérésis d'un tas, ou [XMemSetAllocationHysteresis](https://docs.xbox.com/fr-CA/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-CA/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-CA/reference/system/xmem/structs/xalloc_attributes.md)\
[XMem](https://docs.xbox.com/fr-CA/reference/system/xmem/xmem_members.md)


## Related topics

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