XMemAlloc
Représente une fonction de rappel d’allocation de mémoire définie par l’application qui remplace l’allocateur de mémoire par défaut.Syntaxe
Paramètres
Size _In_Type : SIZE_T La taille du bloc de mémoire demandé, en octets. Attributes _In_
Type : ULONGLONG Les attributs de l’allocation de mémoire. Pour plus d’informations, consultez XALLOC_ATTRIBUTES.
Valeur de retour
Type : PVOID Un pointeur vers la mémoire allouée, en cas de réussite; sinon,NULL.
Remarques
Vous pouvez implémenter cette fonction pour fournir une allocation de mémoire propre à l’application. La définition de cette fonction doit correspondre à celle de la fonction XMEMALLOC_ROUTINE. De même, vous pouvez également implémenter la fonction XMemFree, en respectant la définition de la fonction XMEMFREE_ROUTINE, pour fournir une désallocation de mémoire propre à l’application. Une fois ces fonctions implémentées, vous pouvez utiliser la fonction XMemSetAllocationHooks pour remplacer les fonctions d’allocation et de désallocation de mémoire par défaut par vos propres fonctionsXMemAlloc et XMemFree propres à l’application. Pour plus d’informations sur XMemAlloc, consultez Vue d’ensemble de la mémoire graphique pour le GDK.
Le code source de l’implémentation par défaut de XMemAlloc est installé avec le Microsoft Game Development Kit (GDK). Pour plus d’informations, consultez la fonction
XMemAllocDefault dans \GXDK\gameKit\Source\amd64\heap.c.Si vous implémentez votre propre fonction XMemAlloc, il est d’une importance capitale de ne pas y effectuer d’appel au pilote Direct3D 12. En effet, le fonctionnement normal du pilote peut entraîner l’appel de XMemAlloc sans aucune protection contre la récursivité. Cette exigence s’étend à l’interdiction d’effectuer des opérations Release finales sur des objets Direct3D 12, car celles-ci peuvent entraîner des appels implicites au pilote.
Configuration requise
En-tête : xmem.h Bibliothèque : xmem.lib Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
Voir aussi
Diagnostics et suivi de la mémoireXMem
XMemAllocDefault