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

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

<a id="syntaxSection" />

## Syntaxe

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

<a id="parametersSection" />

### Paramètres

*MemType*   \_In\_\
Type : DWORD

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

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

<a id="retvalSection" />

### Valeur renvoyée

Type : BOOL

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

<a id="remarksSection" />

## 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](/fr/reference/system/xmem/functions/xmemgetallocationhysteresis) pour obtenir la valeur d'hystérésis d'un tas, ou [XMemSetAllocationHysteresis](/fr/reference/system/xmem/functions/xmemsetallocationhysteresis) pour spécifier la valeur d'hystérésis d'un tas. Pour plus d'informations, consultez [Mémoire](/fr/build/console-features/memory/system-memory-overview).

<a id="requirementsSection" />

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

<a id="seealsoSection" />

## Voir aussi

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


## Related topics

- [XMemPreallocateFreeSpace](/reference/system/xmem/functions/xmempreallocatefreespace.md)
- [XPersistentLocalStorageSpaceInfo](/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XPersistentLocalStorageGetSpaceInfo](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md)
- [XPersistentLocalStoragePromptUserForSpaceResult](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragepromptuserforspaceresult.md)
- [Working with the Microsoft GDK Game OS memory manager](/build/console-features/memory/system-memory-working.md)