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

# XMEMALLOC_ROUTINE 回呼

> XMEMALLOC_ROUTINE 回呼

# XMEMALLOC\_ROUTINE 回呼

定義記憶體配置常式 [XMemAlloc](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemalloc.md) 和 `XMemAllocDefault` 的語法。

## 語法

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

### 參數

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

所要求之記憶體區塊的大小 (以位元組為單位)。

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

記憶體配置的屬性。如需詳細資訊，請參閱 [XALLOC\_ATTRIBUTES](https://docs.xbox.com/zh-TW/reference/system/xmem/structs/xalloc_attributes.md)。

### 傳回值

類型：PVOID

如果成功，則為已配置記憶體的指標；否則為 `NULL`。

## 備註

此函式定義用於 [XMEM\_ALLOCATION\_HOOKS](https://docs.xbox.com/zh-TW/reference/system/xmem/structs/xmem_allocation_hooks.md) 結構中，以定義 [XMemAlloc](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemalloc.md) 和 `XMemAllocDefault` 函式。同樣地，[XMEMFREE\_ROUTINE](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemfree_routine.md) 函式定義用於定義 [XMemFree](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemfree.md) 和 `XMemFreeDefault` 函式。

> [!NOTE]
>
> `XMemAlloc` 預設實作的原始程式碼會隨 Microsoft Game Development Kit (GDK) 一起安裝。如需詳細資訊，請參閱 `\GXDK\gameKit\Source\amd64\heap.c` 中的 `XMemAllocDefault` 函式。

## 需求

**標頭：** xmem.h

**程式庫：** xmem.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[診斷與記憶體追蹤](https://docs.xbox.com/zh-TW/build/console-features/memory/system-memory-diagnostics.md)\
[XMem](https://docs.xbox.com/zh-TW/reference/system/xmem/xmem_members.md)\
[XMemAllocDefault](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemallocdefault.md)


## Related topics

- [XMEMFREE_ROUTINE 回呼](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/xmemfree_routine.md)
- [PHEAP_TRACK_REALLOC_ROUTINE 回呼](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/pheap_track_realloc_routine.md)
- [PHEAP_TRACK_ALLOC_ROUTINE 回呼](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/pheap_track_alloc_routine.md)
- [PHEAP_TRACK_FREE_ROUTINE 回呼](https://docs.xbox.com/zh-TW/reference/system/xmem/functions/pheap_track_free_routine.md)
- [XMEM_ALLOCATION_HOOKS](https://docs.xbox.com/zh-TW/reference/system/xmem/structs/xmem_allocation_hooks.md)