> ## 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.

# XMEMALLOC_ROUTINE callback

> XMEMALLOC_ROUTINE callback

# XMEMALLOC\_ROUTINE callback

定义内存分配例程 [XMemAlloc](/reference/system/xmem/functions/xmemalloc) 和 `XMemAllocDefault` 的语法。

<a id="syntaxSection" />

## 语法

```cpp theme={null}
PVOID XMEMALLOC_ROUTINE(  
         SIZE_T Size,  
         ULONGLONG Attributes  
)  
```

<a id="parametersSection" />

### 参数

*Size*   \_In\_\
类型：SIZE\_T

正在请求的内存块大小（以字节为单位）。

*Attributes*   \_In\_\
类型：ULONGLONG

内存分配的属性。有关更多信息，请参阅 [XALLOC\_ATTRIBUTES](/reference/system/xmem/structs/xalloc_attributes)。

<a id="retvalSection" />

### 返回值

类型：PVOID

如果成功，则为指向已分配内存的指针；否则为 `NULL`。

<a id="remarksSection" />

## 备注

此函数定义在 [XMEM\_ALLOCATION\_HOOKS](/reference/system/xmem/structs/xmem_allocation_hooks) 结构中用于定义 [XMemAlloc](/reference/system/xmem/functions/xmemalloc) 和 `XMemAllocDefault` 函数。同样，[XMEMFREE\_ROUTINE](/reference/system/xmem/functions/xmemfree_routine) 函数定义用于定义 [XMemFree](/reference/system/xmem/functions/xmemfree) 和 `XMemFreeDefault` 函数。

<Note>`XMemAlloc` 默认实现的源代码作为 Microsoft Game Development Kit (GDK) 的一部分进行安装。有关更多信息，请参阅 `\GXDK\gameKit\Source\amd64\heap.c` 中的 `XMemAllocDefault` 函数。</Note>

<a id="requirementsSection" />

## 要求

**标头：** xmem.h

**库：** xmem.lib

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

<a id="seealsoSection" />

## 请参阅

[诊断与内存跟踪](/build/console-features/memory/system-memory-diagnostics)\
[XMem](/reference/system/xmem/xmem_members)\
[XMemAllocDefault](/reference/system/xmem/functions/xmemallocdefault)


## Related topics

- [XMEMFREE_ROUTINE callback](/zh-CN/reference/system/xmem/functions/xmemfree_routine.md)
- [PHEAP_TRACK_ALLOC_ROUTINE callback](/zh-CN/reference/system/xmem/functions/pheap_track_alloc_routine.md)
- [PHEAP_TRACK_FREE_ROUTINE callback](/zh-CN/reference/system/xmem/functions/pheap_track_free_routine.md)
- [PHEAP_TRACK_REALLOC_ROUTINE callback](/zh-CN/reference/system/xmem/functions/pheap_track_realloc_routine.md)
- [XMEM_ALLOCATION_HOOKS](/zh-CN/reference/system/xmem/structs/xmem_allocation_hooks.md)