PIXRecordMemoryFreeEvent
Enregistre un événement de libération de mémoire.Syntaxe
Paramètres
allocatorIdType : 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
Type : void* Adresse de départ de la mémoire qui a été libérée. size
Type : size_t Taille, en octets, de la mémoire qui a été libérée. metadata
Type : UINT64 Entier non signé de 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 utiliser ces données supplémentaires pour identifier, par exemple, le type d’objet de votre titre qui a été libéré à un emplacement de mémoire donné. La valeur passée à
PIXRecordMemoryFreeEvent ne doit pas nécessairement correspondre à la valeur passée à l’appel correspondant à PIXRecordMemoryAllocationEvent.
Valeur de retour
Type : voidRemarques
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 repérer l’allocation correspondante de la façon suivante : si baseAddress correspond au baseAddress passé à l’appel correspondant à 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 trouve 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 de capture de mémoire de PIX affichera un avertissement indiquant une 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 SeriesDocumentation conceptuelle
Voir aussi
Allocateurs de mémoire personnalisés PIX (rubrique sous NDA) Référence de l’API PIXPIXRecordMemoryAllocationEvent
PIX (rubrique sous NDA)