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

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

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*MemType*   \_In\_\
Tipo: DWORD

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

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

<a id="retvalSection" />

### Valor devuelto

Tipo: BOOL

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

<a id="remarksSection" />

## 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](/reference/system/xmem/functions/xmemgetallocationhysteresis) para obtener la cantidad de histéresis de un montón, o [XMemSetAllocationHysteresis](/reference/system/xmem/functions/xmemsetallocationhysteresis) para especificar la cantidad de histéresis de un montón. Para obtener más información, consulte [Memoria](/build/console-features/memory/system-memory-overview).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xmem.h

**Biblioteca:** xmem.lib

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

<a id="seealsoSection" />

## Consulte también

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


## Related topics

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