XMEM_OPTIONS - XBOX Game Development Documentation

The XMEM_OPTIONS values are used as the Option parameter for the XMEM_OPTION struct. The parameter type indicates which parameter (Bool, Int, or Pointer) should be set when populating the struct.

Syntax

typedef enum _XMEM_OPTIONS    
{  
    eXMEMOPT_VALIDATE_XMEMALLOC = 0x1,  
    eXMEMOPT_XMEMALLOCDEFAULT_TAG_VIRTUALALLOC = 0x2,  
    eXMEMOPT_RAISE_HEAPFREE_CALLBACK_ON_REALLOC = 0x3,  
    eXMEMOPT_XMEMALLOCDEFAULT_DISABLEPAGESIZEDEMOTION = 0x4,  
    eXMEMOPT_XMEMALLOCDEFAULT_TRAPUSEAFTERFREE = 0x5,  
    eXMEMOPT_XMEMALLOCDEFAULT_USE64KPAGES = 0x6,
    eXMEMOPT_ALLOW_WRITEABLE_FILEMAPPINGS = 0x7,
    eXMEMOPT_MAX = 0xFFFF,
} XMEM_OPTIONS  

Constants

Constant	Parameter Type	Description
eXMEMOPT_VALIDATE_XMEMALLOC	BOOL	Enables runtime validation of memory returned by XMemAlloc.
eXMEMOPT_XMEMALLOCDEFAULT_TAG_VIRTUALALLOC	BOOL	Enables commit tagging of XMemVirtualAlloc allocations made by XMemAllocDefault.
eXMEMOPT_RAISE_HEAPFREE_CALLBACK_ON_REALLOC	BOOL	Enables raising a heapfree callback on reallocations.
eXMEMOPT_XMEMALLOCDEFAULT_DISABLEPAGESIZEDEMOTION	BOOL	Disables automatic demotion from 2MB to 64KB for the XMem heaps.
eXMEMOPT_XMEMALLOCDEFAULT_TRAPUSEAFTERFREE	BOOL	Promotes all XMemAlloc/XMemFree calls that utilize the internal heaps to XMemVirtualAlloc/VirtualFree
eXMEMOPT_XMEMALLOCDEFAULT_USE64KPAGES	BOOL	Configures the XMem heaps to use 64KB pages instead of 2MB pages
eXMEMOPT_ALLOW_WRITEABLE_FILEMAPPINGS	BOOL	If enabled, allows CreateFileMappingA/W to succeed when called with writeable flags

Requirements

Header: xmem.h Supported Platforms: XBOX One family consoles and XBOX Series consoles

See also

Last modified on October 29, 2026

⌘I