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

Asigna páginas libres para un montón hasta su valor de histéresis.

## Sintaxis

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

### Parámetros

*MemType*   \_In\_\
Tipo: DWORD

Constante **XALLOC\_MEMTYPE\_GRAPHICS** que describe el montón. Para obtener más información, consulte [XALLOC\_ATTRIBUTES](https://docs.xbox.com/es/reference/system/xmem/structs/xalloc_attributes.md).

*LargeHeap*   \_In\_\
Tipo: BOOL

Indica si el montón es "grande". Si se establece en true, el montón se considera "grande"; de lo contrario, el montón se considera "pequeño". Los montones "grandes" se usan para satisfacer asignaciones de entre 4 KB y 128 KB, o cuya alineación se especifica como 4 KB o superior; y los montones "pequeños" se usan para satisfacer asignaciones inferiores a 4 KB y cuya alineación se especifica como inferior a 4 KB.

### Valor devuelto

Tipo: BOOL

Devuelve `TRUE` si se pudieron asignar todas las páginas; de lo contrario, `FALSE`.

## Comentarios

Esta función asigna espacio libre para el montón descrito en *MemType*, hasta la cantidad de histéresis de ese montón. Use [XMemGetAllocationHysteresis](https://docs.xbox.com/es/reference/system/xmem/functions/xmemgetallocationhysteresis.md) para obtener la cantidad de histéresis de un montón, o [XMemSetAllocationHysteresis](https://docs.xbox.com/es/reference/system/xmem/functions/xmemsetallocationhysteresis.md) para especificar la cantidad de histéresis de un montón. Para obtener más información, consulte [Memoria](https://docs.xbox.com/es/build/console-features/memory/system-memory-overview.md).

## Requisitos

**Encabezado:** xmem.h

**Biblioteca:** xmem.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

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