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

# XMemSetAllocationHooks

> XMemSetAllocationHooks

# XMemSetAllocationHooks

Esta API foi preterida. Consulte [XMEM\_ALLOCATION\_HOOKS](https://docs.xbox.com/pt-BR/reference/system/xmem/structs/xmem_allocation_hooks.md) em vez disso.

Usada por títulos para registrar ganchos de alocação de memória.

## Sintaxe

```cpp theme={null}
VOID XMemSetAllocationHooks(  
         PXMEMALLOC_ROUTINE AllocRoutine,  
         PXMEMFREE_ROUTINE FreeRoutine  
)  
```

### Parâmetros

*AllocRoutine*   \_In\_\
Tipo: PXMEMALLOC\_ROUTINE

Ponteiro para a função de alocação do título. Confira o tópico [XMEMALLOC\_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemalloc_routine.md) para obter a definição dessa função.

*FreeRoutine*   \_In\_\
Tipo: PXMEMFREE\_ROUTINE

Ponteiro para a função de desalocação do título. Confira o tópico [XMEMFREE\_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemfree_routine.md) para obter a definição dessa função.

### Valor retornado

Tipo: VOID

## Comentários

As alocações podem ser monitoradas (ou substituídas) com um retorno de chamada fornecido pelo título por meio da função **XMemSetAllocationHooks**. Com o uso adequado dessa API, os títulos podem rastrear quase todas as alocações feitas a partir do código do título, bem como a maior parte do código da plataforma.

Se os títulos optarem por não fornecer seus próprios ganchos de alocação, **XMemAllocDefault** e **XMemFreeDefault** serão usados (confira xmem.h para ver a declaração desses ganchos). Se os títulos quiserem fornecer ganchos de alocação para fins de rastreamento, mas não quiserem implementar seu próprio alocador, eles poderão chamar o alocador padrão diretamente.

É importante fornecer uma implementação tanto para [XMEMALLOC\_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemalloc_routine.md) quanto para [XMEMFREE\_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemfree_routine.md) se você interceptá-las; interceptar apenas uma delas será considerado um erro.

## 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](https://docs.xbox.com/pt-BR/reference/system/xmem/xmem_members.md)\
[XMEMALLOC\_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemalloc_routine.md)\
[XMEMFREE\_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemfree_routine.md)


## Related topics

- [XMEM_ALLOCATION_HOOKS](https://docs.xbox.com/pt-BR/reference/system/xmem/structs/xmem_allocation_hooks.md)
- [XMEM_SET_ALLOCATION_HOOKS](https://docs.xbox.com/pt-BR/reference/system/xmem/macros/xmem_set_allocation_hooks.md)
- [XMemSetWin32HeapTrackingHooks](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md)
- [XMemFreeDefault](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemfreedefault.md)
- [Hooks de memória](https://docs.xbox.com/pt-BR/services/playfab/sdks/c/memory.md)