Skip to main content

​
XMemCreateWin32Heap

Crée un tas Win32.

​
Syntaxe

​
Paramètres

HeapFlags _In_
Type : ULONGLONG Indique la source de mémoire du tas à créer. baseAddress _In_
Type : PVOID L’adresse de base pour l’allocation du tas sur place. Si HeapFlags est défini à 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 à NULL.

​
Valeur de retour

Type : HANDLE Retourne un handle vers le tas Win32 créé, en cas de réussite; sinon, retourne 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 est soutenu par des pages de 2 Mo (ou 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 retourne 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 trousse de développement.

​
Allocation de mémoire d’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, selon les 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 de 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 et peut être utilisée pendant le développement pour tout ce qui va des outils de 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