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

# XMemGetAllocationHysteresis

> XMemGetAllocationHysteresis retorna o valor de histerese de um heap de título do XBOX GDK, arredondado para cima até o próximo limite de alocação interno.

# XMemGetAllocationHysteresis

Obtém o valor de histerese de um determinado heap, arredondado para cima até um limite de alocação interno.

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*MemType*   \_In\_<br />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\_<br />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: SIZE\_T

O valor da histerese, em bytes. A implementação do heap pode arredondar para cima o valor de histerese especificado até um limite de alocação interno.

<a id="remarksSection" />

## Comentários

Essa função obtém o *valor de histerese*, a quantidade mínima de memória livre que será retida pelo heap antes que memória livre adicional seja devolvida ao sistema operacional, para um determinado heap. O valor de histerese retornado por essa função é arredondado para cima até um limite de alocação interno. Atualmente, o limite de alocação interno está definido como 2 MB.

Para definir o valor de histerese de um determinado heap, use [XMemSetAllocationHysteresis](/pt-BR/reference/system/xmem/functions/xmemsetallocationhysteresis).

<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)<br />[XMem](/pt-BR/reference/system/xmem/xmem_members)


## Related topics

- [XMemPreallocateFreeSpace](/reference/system/xmem/functions/xmempreallocatefreespace.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [PFMemGetFunctions](/services/playfab/api-references/c/pfplatform/functions/pfmemgetfunctions.md)
- [HCMemGetFunctions](/reference/live/httpclient/httpclient/functions/hcmemgetfunctions.md)
- [XMEM_ALLOCATION_HOOKS](/reference/system/xmem/structs/xmem_allocation_hooks.md)