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

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

## Sintaxe

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

### Parâmetros

*MemType*   \_In\_\
Tipo: DWORD

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

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

### Valor retornado

Tipo: BOOL

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

## Comentários

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

## Requisitos

**Cabeçalho:** xmem.h

**Biblioteca:** xmem.lib

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

## Confira também

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


## Related topics

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