> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XMEM_OPTIONS

> XMEM_OPTIONS

# XMEM\_OPTIONS

**XMEM\_OPTIONS** 值用作 [XMEM\_OPTION](/reference/system/xmem/structs/xmem_option) 结构的 *Option* 参数。参数类型指示在填充结构时应设置哪个参数（Bool、Int 或 Pointer）。

## 语法

```cpp theme={null}
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  
```

## 常量

| 常量                                                  | 参数类型 | 说明                                                              |
| --------------------------------------------------- | ---- | --------------------------------------------------------------- |
| eXMEMOPT\_VALIDATE\_XMEMALLOC                       | BOOL | 启用对 XMemAlloc 返回的内存的运行时验证。                                      |
| eXMEMOPT\_XMEMALLOCDEFAULT\_TAG\_VIRTUALALLOC       | BOOL | 启用对由 XMemAllocDefault 进行的 XMemVirtualAlloc 分配的提交标记。             |
| eXMEMOPT\_RAISE\_HEAPFREE\_CALLBACK\_ON\_REALLOC    | BOOL | 启用在重新分配时触发 heapfree 回调。                                         |
| eXMEMOPT\_XMEMALLOCDEFAULT\_DISABLEPAGESIZEDEMOTION | BOOL | 禁用 XMem 堆从 2MB 到 64KB 的自动降级。                                    |
| eXMEMOPT\_XMEMALLOCDEFAULT\_TRAPUSEAFTERFREE        | BOOL | 将所有使用内部堆的 XMemAlloc/XMemFree 调用提升为 XMemVirtualAlloc/VirtualFree |
| eXMEMOPT\_XMEMALLOCDEFAULT\_USE64KPAGES             | BOOL | 将 XMem 堆配置为使用 64KB 页而非 2MB 页                                    |
| eXMEMOPT\_ALLOW\_WRITEABLE\_FILEMAPPINGS            | BOOL | 如果启用，则允许在使用可写标志调用 CreateFileMappingA/W 时成功                      |

## 要求

**标头：** xmem.h
**支持的平台**：XBOX One 系列主机和 XBOX Series 主机

## 请参阅

[xmem](/reference/system/xmem/xmem_members)


## Related topics

- [XMEM_OPTION](/zh-CN/reference/system/xmem/structs/xmem_option.md)
- [XMemSetOption](/zh-CN/reference/system/xmem/functions/xmemsetoption.md)
- [XMemVirtualQuery](/zh-CN/reference/system/xmem/functions/xmemvirtualquery.md)
- [XMEM_ALLOCATION_HOOKS](/zh-CN/reference/system/xmem/structs/xmem_allocation_hooks.md)
- [XMemGetWorkingSetStatistics](/zh-CN/reference/system/xmem/functions/xmemgetworkingsetstatistics.md)