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

La constante **XALLOC\_MEMTYPE\_GRAPHICS** qui décrit le tas. Pour plus d'informations, consultez [XALLOC\_ATTRIBUTES](/fr-CA/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, 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.

<a id="retvalSection" />

### Valeur de retour

Type : BOOL

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