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

# XMemSetAllocationHooks

> XMemSetAllocationHooks

# XMemSetAllocationHooks

Esta API foi preterida. Consulte [XMEM\_ALLOCATION\_HOOKS](/pt-BR/reference/system/xmem/structs/xmem_allocation_hooks) 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](/pt-BR/reference/system/xmem/functions/xmemalloc_routine) 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](/pt-BR/reference/system/xmem/functions/xmemfree_routine) 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](/pt-BR/reference/system/xmem/functions/xmemalloc_routine) quanto para [XMEMFREE\_ROUTINE](/pt-BR/reference/system/xmem/functions/xmemfree_routine) 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](/pt-BR/reference/system/xmem/xmem_members)\
[XMEMALLOC\_ROUTINE](/pt-BR/reference/system/xmem/functions/xmemalloc_routine)\
[XMEMFREE\_ROUTINE](/pt-BR/reference/system/xmem/functions/xmemfree_routine)


## Related topics

- [XMemSetAllocationHooks](/reference/system/xmem/functions/xmemsetallocationhooks.md)
- [XMEM_ALLOCATION_HOOKS](/reference/system/xmem/structs/xmem_allocation_hooks.md)