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

# PIXRecordMemoryAllocationEvent

> PIXRecordMemoryAllocationEvent

# PIXRecordMemoryAllocationEvent

Enregistre un événement d'allocation de mémoire.

## Syntaxe

```cpp theme={null}
void PIXRecordMemoryAllocationEvent(  
         USHORT allocatorId,  
         void* baseAddress,  
         size_t size,  
         UINT64 metadata  
)  
```

### Paramètres

*allocatorId*   <br />Type : USHORT

Identificateur que vous pouvez utiliser pour identifier des groupes d'allocations de mémoire dans le profileur de mémoire. Par exemple, si vous avez différents tas pour des éléments comme les graphiques, l'audio et la physique, vous pouvez attribuer à chacune de ces catégories un **allocatorID** différent afin de les repérer facilement lors de l'affichage d'une capture de mémoire dans PIX.

*baseAddress*   <br />Type : void\*

Adresse de départ de la mémoire qui a été allouée.

*size*   <br />Type : size\_t

Taille, en octets, de la mémoire qui a été allouée.

*metadata*   <br />Type : UINT64

Entier non signé de 64 bits que vous pouvez utiliser pour étiqueter une allocation avec des données supplémentaires. Ces données supplémentaires sont affichées dans PIX dans une colonne **UserData**. Vous pouvez utiliser ces données supplémentaires pour identifier, par exemple, le type d'objet de votre titre qui est stocké à un emplacement de mémoire donné.

### Valeur de retour

Type : void

## Remarques

Un événement de suivi de la mémoire PIX fournit les données dont PIX a besoin pour afficher, dans les captures de profilage de la mémoire, des informations sur toutes les allocations et libérations de mémoire effectuées par les allocateurs de mémoire personnalisés du titre. Grâce à ces données, PIX affiche pour vos allocateurs personnalisés les mêmes données que pour les appels à **VirtualAlloc**/**VirtualFree** et **HeapAlloc**/**HeapFree**.

Si de nombreux événements se produisent en même temps ou si le système est soumis à une charge importante, des événements de mémoire peuvent être perdus par le suivi d'événements pour Windows (ETW). La perte d'événements entraîne une analyse incomplète des données. L'interface utilisateur de capture de mémoire de PIX affichera un avertissement indiquant une perte d'événements.

Plusieurs appels à [PIXRecordMemoryFreeEvent](/fr-CA/reference/tools/pix3/functions/pixrecordmemoryfreeevent) peuvent être utilisés pour suivre la mémoire libérée progressivement à partir d'une seule allocation.

Consultez [Allocateurs de mémoire personnalisés PIX (rubrique sous NDA)](/fr-CA/tools/tools-console/pix/pix-custom-memory-allocators) pour savoir comment les données des allocations et libérations personnalisées sont affichées dans les captures de mémoire.

## Configuration requise

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

**Bibliothèque :** pixevt.lib

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

## Documentation conceptuelle

* [Liste de vérification de l'engagement des systèmes ATG](/fr-CA/build/atg-engagement/atg-systems-engagement)

## Voir aussi

[PIX (rubrique sous NDA)](/fr-CA/tools/tools-console/pix/pix)

[Allocateurs de mémoire personnalisés PIX (rubrique sous NDA)](/fr-CA/tools/tools-console/pix/pix-custom-memory-allocators)

[Référence de l'API PIX](/fr-CA/reference/tools/pix3/pix3_members)

[PIXRecordMemoryFreeEvent](/fr-CA/reference/tools/pix3/functions/pixrecordmemoryfreeevent)


## Related topics

- [PIXRecordMemoryFreeEvent](/fr-CA/reference/tools/pix3/functions/pixrecordmemoryfreeevent.md)
- [PIX3](/fr-CA/reference/tools/pix3/pix3_members.md)
- [PFMemoryHooks](/fr-CA/services/playfab/api-references/c/pfplatform/structs/pfmemoryhooks.md)
- [game_chat_allocate_memory_callback](/fr-CA/reference/chat/gamechat2/functions/game_chat_allocate_memory_callback.md)
- [chat_manager::get_memory_callbacks](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_get_memory_callbacks.md)