Skip to main content

​
XMemCreateWin32Heap

Crée un tas Win32.

​
Syntaxe

​
Paramètres

HeapFlags _In_
Type : ULONGLONG Indique la source de la mémoire du tas à créer. baseAddress _In_
Type : PVOID Adresse de base de l’allocation de tas sur place. Si HeapFlags est défini sur XMEM_HEAP_INPLACE, cette valeur doit pointer vers une adresse en mémoire validée alignée sur une limite de 4 Ko ; sinon, cette valeur doit être définie sur NULL.

​
Valeur renvoyée

Type : HANDLE Renvoie un handle vers le tas Win32 créé en cas de réussite ; sinon, renvoie NULL. Si elles sont disponibles, des informations d’erreur étendues sont fournies au rappel XErrorCallback actuel de votre application.

​
Remarques

Cette fonction crée un tas Win32, en allouant la mémoire du tas à partir de la source et de l’adresse de base indiquées respectivement par HeapFlags et baseAddress. Si XMEM_HEAP_INPLACE n’a pas été spécifié dans HeapFlags lors de la création du tas, le tas s’appuie sur des pages de 2 Mo (ou sur des pages de 64 Ko si XMEM_HEAP_64K_PAGES est spécifié). Si une erreur se produit lors de la tentative de création d’un tas Win32, cette méthode renvoie NULL et, si possible, l’erreur est signalée au rappel XErrorCallback actuel de votre application. Pour plus d’informations sur la gestion des cas d’erreur exceptionnels, consultez XError. Pour plus d’informations sur la configuration de la mémoire et l’accès à celle-ci, consultez Configuration de la mémoire pour votre titre et votre kit de développement.

​
Allocation de mémoire des outils

Si XMEM_HEAP_TOOL est spécifié dans HeapFlags, la fonction tente d’allouer de la mémoire à partir de la partition des outils pour créer le tas Win32, en fonction des paramètres du mode Profilage et du mode Itération :
  • Si le mode Itération est désactivé et que le mode Profilage est activé, la fonction tente d’allouer la quantité de mémoire demandée à partir de la partition des outils. Si la quantité demandée n’est pas disponible, une erreur se produit.
  • Si le mode Itération est désactivé et que le mode Profilage est désactivé, une erreur se produit.
  • Si le mode Itération est activé, la fonction tente d’allouer la quantité de mémoire demandée à partir de la partition du titre. Si la quantité demandée n’est pas disponible, une erreur se produit.
Lorsque le mode Profilage est activé, de la mémoire supplémentaire est mise à la disposition de votre titre ; elle peut être utilisée pendant le développement pour tout usage, des outils du moteur de jeu aux ressources de jeu non optimisées. Pour plus d’informations sur le mode Profilage, consultez Mode Profilage. La partition des outils n’est pas disponible lorsque le mode Itération est activé. Vous pouvez utiliser la fonction XMemIsToolsMemAvailable pour vérifier si la mémoire de la partition des outils est disponible en mode Profilage.

​
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

Mémoire
XMem
Last modified on October 6, 2026