Skip to main content

​
XMemCreateWin32Heap

Crea un montón Win32.

​
Sintaxis

​
Parámetros

HeapFlags _In_
Tipo: ULONGLONG Indica el origen de la memoria del montón que se va a crear. baseAddress _In_
Tipo: PVOID La dirección base para la asignación del montón in situ. Si HeapFlags se establece en XMEM_HEAP_INPLACE, este valor debe apuntar a una dirección en memoria confirmada que esté alineada con un límite de 4 KB; de lo contrario, este valor debe establecerse en NULL.

​
Valor devuelto

Tipo: HANDLE Devuelve un identificador del montón Win32 creado, si se realiza correctamente; de lo contrario, devuelve NULL. Si está disponible, se proporciona información de error extendida a la devolución de llamada XErrorCallback actual de su aplicación.

​
Comentarios

Esta función crea un montón Win32, asignando memoria para el montón desde el origen y la dirección base indicados por HeapFlags y baseAddress, respectivamente. Si no se especificó XMEM_HEAP_INPLACE en HeapFlags cuando se creó el montón, el montón está respaldado por páginas de 2 MB (o páginas de 64 KB si se especifica XMEM_HEAP_64K_PAGES). Si se produce un error al intentar crear un montón Win32, este método devuelve NULL y, si está disponible, el error se notifica a la devolución de llamada XErrorCallback actual de su aplicación. Para obtener más información sobre cómo controlar casos de error excepcionales, consulte XError. Para obtener más información sobre cómo configurar y acceder a la memoria, consulte Configuración de la memoria para su título y kit de desarrollo.

​
Asignación de memoria de herramientas

Si se especifica XMEM_HEAP_TOOL en HeapFlags, la función intenta asignar memoria desde la partición de herramientas para crear el montón Win32, en función de la configuración del modo de generación de perfiles y del modo de iteración:
  • Si el modo de iteración está deshabilitado y el modo de generación de perfiles está habilitado, la función intenta asignar la cantidad de memoria solicitada desde la partición de herramientas. Si la cantidad solicitada no está disponible, se produce un error.
  • Si el modo de iteración está deshabilitado y el modo de generación de perfiles está deshabilitado, se produce un error.
  • Si el modo de iteración está habilitado, la función intenta asignar la cantidad de memoria solicitada desde la partición del título. Si la cantidad solicitada no está disponible, se produce un error.
Cuando el modo de generación de perfiles está habilitado, se pone a disposición de su título memoria adicional que se puede usar durante el desarrollo para cualquier cosa, desde herramientas del motor de juego hasta recursos de juego sin optimizar. Para obtener más información sobre el modo de generación de perfiles, consulte Modo de generación de perfiles. La partición de herramientas no está disponible cuando el modo de iteración está habilitado. Puede usar la función XMemIsToolsMemAvailable para comprobar si la memoria de la partición de herramientas está disponible en el modo de generación de perfiles.

​
Requisitos

Encabezado: xmem.h Biblioteca: xmem.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

​
Consulte también

Memoria
XMem
Última modificación el 28 de agosto de 2026