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

Cette API est dépréciée. Reportez-vous plutôt à [XMEM\_ALLOCATION\_HOOKS](https://docs.xbox.com/fr-CA/reference/system/xmem/structs/xmem_allocation_hooks.md).

Utilisée par les titres pour inscrire des crochets d'allocation de mémoire.

## Syntaxe

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

### Paramètres

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

Pointeur vers la fonction d'allocation du titre. Consultez la rubrique [XMEMALLOC\_ROUTINE](https://docs.xbox.com/fr-CA/reference/system/xmem/functions/xmemalloc_routine.md) pour la définition de cette fonction.

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

Pointeur vers la fonction de désallocation du titre. Consultez la rubrique [XMEMFREE\_ROUTINE](https://docs.xbox.com/fr-CA/reference/system/xmem/functions/xmemfree_routine.md) pour la définition de cette fonction.

### Valeur de retour

Type : VOID

## Remarques

Les allocations peuvent être surveillées (ou remplacées) au moyen d'un rappel fourni par le titre grâce à la fonction **XMemSetAllocationHooks**. En utilisant correctement cette API, les titres peuvent suivre presque toutes les allocations effectuées à partir du code du titre ainsi que la majorité du code de la plateforme.

Si les titres choisissent de ne pas fournir leurs propres crochets d'allocation, **XMemAllocDefault** et **XMemFreeDefault** seront utilisées à la place (consultez xmem.h pour la déclaration de ces crochets). Si les titres souhaitent fournir des crochets d'allocation à des fins de suivi, mais ne veulent pas implémenter leur propre allocateur, ils peuvent appeler directement l'allocateur par défaut.

Il est important de fournir une implémentation à la fois pour [XMEMALLOC\_ROUTINE](https://docs.xbox.com/fr-CA/reference/system/xmem/functions/xmemalloc_routine.md) et [XMEMFREE\_ROUTINE](https://docs.xbox.com/fr-CA/reference/system/xmem/functions/xmemfree_routine.md) si vous les interceptez; n'en intercepter qu'une seule sera considéré comme une erreur.

## Configuration requise

**En-tête :** xmem.h

**Bibliothèque :** xmem.lib

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Référence XMem](https://docs.xbox.com/fr-CA/reference/system/xmem/xmem_members.md)\
[XMEMALLOC\_ROUTINE](https://docs.xbox.com/fr-CA/reference/system/xmem/functions/xmemalloc_routine.md)\
[XMEMFREE\_ROUTINE](https://docs.xbox.com/fr-CA/reference/system/xmem/functions/xmemfree_routine.md)


## Related topics

- [XMEM_ALLOCATION_HOOKS](https://docs.xbox.com/fr-CA/reference/system/xmem/structs/xmem_allocation_hooks.md)
- [XMEM_SET_ALLOCATION_HOOKS](https://docs.xbox.com/fr-CA/reference/system/xmem/macros/xmem_set_allocation_hooks.md)
- [XMemSetWin32HeapTrackingHooks](https://docs.xbox.com/fr-CA/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md)
- [XMemFreeDefault](https://docs.xbox.com/fr-CA/reference/system/xmem/functions/xmemfreedefault.md)
- [Hooks de mémoire](https://docs.xbox.com/fr-CA/services/playfab/sdks/c/memory.md)