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

# PIXRecordMemoryFreeEvent

> PIXRecordMemoryFreeEvent

# PIXRecordMemoryFreeEvent

Enregistre un événement de libération de mémoire.

## Syntaxe

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

### Paramètres

*allocatorId*   <br />Type : USHORT

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

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

L'adresse de début de la mémoire libérée.

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

La taille, en octets, de la mémoire libérée.

*metadata*   <br />Type : UINT64

Un entier non signé 64 bits que vous pouvez utiliser pour étiqueter une libération de mémoire avec des données supplémentaires. Ces données supplémentaires sont affichées dans PIX dans une colonne UserData. Vous pouvez par exemple utiliser ces données supplémentaires pour identifier le type d'objet de votre titre qui a été libéré à un emplacement mémoire donné. La valeur passée à `PIXRecordMemoryFreeEvent` n'a pas besoin de correspondre à la valeur passée à l'appel correspondant à [PIXRecordMemoryAllocationEvent](/fr/reference/tools/pix3/functions/pixrecordmemoryallocationevent).

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

PIX utilise les paramètres *baseAddress* et *size* pour localiser l'allocation correspondante comme suit : si *baseAddress* correspond au *baseAddress* passé à l'appel correspondant à [PIXRecordMemoryAllocationEvent](/fr/reference/tools/pix3/functions/pixrecordmemoryallocationevent), PIX associe l'allocation et la libération en comparant simplement les adresses. Dans ce cas, 0 peut être passé pour le paramètre *size*. Si *baseAddress* est différent de la valeur spécifiée dans l'allocation correspondante, le paramètre *size* doit être spécifié avec une valeur non nulle. Dans ce cas, PIX recherche les allocations correspondantes à l'aide de *baseAddress* et de *size*.

Si un grand nombre d'é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 PIX Memory Capture affiche alors un avertissement signalant la perte d'événements.

## 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 contrôle d'engagement des systèmes ATG](/fr/build/atg-engagement/atg-systems-engagement)

## Voir aussi

[Allocateurs de mémoire personnalisés PIX (rubrique NDA)](/fr/tools/tools-console/pix/pix-custom-memory-allocators) [Référence de l'API PIX](/fr/reference/tools/pix3/pix3_members)<br />[PIXRecordMemoryAllocationEvent](/fr/reference/tools/pix3/functions/pixrecordmemoryallocationevent)<br />[PIX (rubrique NDA)](/fr/tools/tools-console/pix/pix)


## Related topics

- [PIXRecordMemoryFreeEvent](/reference/tools/pix3/functions/pixrecordmemoryfreeevent.md)
- [PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/pixrecordmemoryallocationevent.md)