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

# XMemSetAllocationHysteresis

> XMemSetAllocationHysteresis

# XMemSetAllocationHysteresis

Define o valor de histerese de um determinado heap, arredondado para cima até um limite de alocação interno (4 MB).

## Sintaxe

```cpp theme={null}
BOOL XMemSetAllocationHysteresis(  
         DWORD MemType,  
         BOOL LargeHeap,  
         SIZE_T Size  
)  
```

### Parâmetros

*MemType*   \_In\_<br />Tipo: DWORD

Refere-se à constante **XALLOC\_MEMTYPE\_GRAPHICS** que descreve o heap. Confira o tópico [XALLOC\_ATTRIBUTES](/pt-BR/reference/system/xmem/structs/xalloc_attributes) para obter detalhes sobre essas constantes.

*LargeHeap*   \_In\_<br />Tipo: BOOL

True se o heap for "grande"; 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.

*Size*   \_In\_<br />Tipo: SIZE\_T

O valor da histerese (ou seja, a quantidade mínima de memória livre que será retida pelo heap antes que memória livre adicional seja devolvida ao sistema operacional), em bytes. A implementação do heap pode arredondar para cima o valor de histerese especificado até um limite de alocação interno (atualmente 4 MB).

### Valor retornado

Tipo: BOOL

Retorna TRUE se a histerese puder ser definida; caso contrário, FALSE.

## Comentários

A histerese pode ser definida em cada um dos heaps separados que **XMemAllocDefault** mantém. Há heaps separados para cada tipo de memória enumerado pelas constantes XALLOC\_MEMTYPE\_GRAPHICS. **OBSERVAÇÃO:** somente os tipos de gráficos mantêm heaps.

Para obter o valor de histerese de um determinado heap, use [XMemGetAllocationHysteresis](/pt-BR/reference/system/xmem/functions/xmemgetallocationhysteresis).

## Requisitos

**Cabeçalho:** xmem.h

**Biblioteca:** xmem.lib

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

## Confira também

[Referência de XMem](/pt-BR/reference/system/xmem/xmem_members)<br />[XALLOC\_ATTRIBUTES](/pt-BR/reference/system/xmem/structs/xalloc_attributes)<br />[XMemGetAllocationHysteresis](/pt-BR/reference/system/xmem/functions/xmemgetallocationhysteresis)


## Related topics

- [XMemPreallocateFreeSpace](/reference/system/xmem/functions/xmempreallocatefreespace.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [XMemSetAllocationHooks](/ja-jp/reference/system/xmem/functions/xmemsetallocationhooks.md)