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

Aloca páginas livres para um heap até o valor de histerese dele.

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*MemType*   \_In\_\
Tipo: DWORD

A constante **XALLOC\_MEMTYPE\_GRAPHICS** que descreve o heap. Para obter mais informações, confira [XALLOC\_ATTRIBUTES](/pt-BR/reference/system/xmem/structs/xalloc_attributes).

*LargeHeap*   \_In\_\
Tipo: BOOL

Indica se o heap é "grande". Se definido como true, o heap é considerado "grande"; caso contrário, o heap é considerado "pequeno". Heaps "grandes" são usados para atender a alocações de 4 KB a 128 KB ou cujo alinhamento é especificado como 4 KB ou mais; e heaps "pequenos" são usados para atender a alocações menores que 4 KB e cujo alinhamento é especificado como menor que 4 KB.

<a id="retvalSection" />

### Valor retornado

Tipo: BOOL

Retorna `TRUE` se todas as páginas puderem ser alocadas; caso contrário, `FALSE`.

<a id="remarksSection" />

## Comentários

Essa função aloca espaço livre para o heap descrito em *MemType*, até o valor de histerese desse heap. Use [XMemGetAllocationHysteresis](/pt-BR/reference/system/xmem/functions/xmemgetallocationhysteresis) para obter o valor de histerese de um heap ou [XMemSetAllocationHysteresis](/pt-BR/reference/system/xmem/functions/xmemsetallocationhysteresis) para especificar o valor de histerese de um heap. Para obter mais informações, confira [Memória](/pt-BR/build/console-features/memory/system-memory-overview).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xmem.h

**Biblioteca:** xmem.lib

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Confira também

[XALLOC\_ATTRIBUTES](/pt-BR/reference/system/xmem/structs/xalloc_attributes)\
[XMem](/pt-BR/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)