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

# PHEAP_TRACK_REALLOC_ROUTINE callback

> PHEAP_TRACK_REALLOC_ROUTINE callback

# PHEAP\_TRACK\_REALLOC\_ROUTINE callback

表示用于堆重新分配的跟踪回调函数。

## 语法

```cpp theme={null}
void PHEAP_TRACK_REALLOC_ROUTINE(  
         HANDLE Heap,  
         DWORD Flags,  
         SIZE_T Size,  
         PVOID OldAddr,  
         PVOID NewAddr  
)  
```

### 参数

*Heap*   \
类型：HANDLE

从中重新分配内存块的堆的句柄。

*Flags*   \
类型：DWORD

传递给 [HeapReAlloc](https://learn.microsoft.com/windows/desktop/api/heapapi/nf-heapapi-heaprealloc) 的堆重新分配选项。

*Size*   \
类型：SIZE\_T

内存块的新大小（以字节为单位）。

*OldAddr*   \
类型：PVOID

`HeapReAlloc` 重新分配的内存块的原始地址。

*NewAddr*   \
类型：PVOID

重新分配后的内存块的新地址。

### 返回值

类型：void

无。

## 备注

可实现此回调函数以跟踪何时从 Win32 堆重新分配内存块。实现后，必须通过调用 [XMemSetWin32HeapTrackingHooks](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md) 来注册所实现的回调函数。然后，在调用 `HeapReAlloc` 从 Win32 堆重新分配先前已分配的内存块之后，将调用该回调函数。有关实现此回调函数的更多信息，请参阅 `XMemSetWin32HeapTrackingHooks` 的[备注](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md#remarksSection)部分。

## 要求

**标头：** xmem.h

**库：** xmem.lib

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

## 请参阅

[诊断与内存跟踪](https://docs.xbox.com/zh-CN/build/console-features/memory/system-memory-diagnostics.md)\
[XMemCreateWin32Heap](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/xmemcreatewin32heap.md)\
[PHEAP\_TRACK\_ALLOC\_ROUTINE](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/pheap_track_alloc_routine.md)\
[PHEAP\_TRACK\_FREE\_ROUTINE](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/pheap_track_free_routine.md)\
[XMem](https://docs.xbox.com/zh-CN/reference/system/xmem/xmem_members.md)


## Related topics

- [PHEAP_TRACK_ALLOC_ROUTINE callback](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/pheap_track_alloc_routine.md)
- [PHEAP_TRACK_FREE_ROUTINE callback](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/pheap_track_free_routine.md)
- [XMemSetWin32HeapTrackingHooks](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md)
- [XMEMALLOC_ROUTINE callback](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/xmemalloc_routine.md)
- [XMEMFREE_ROUTINE callback](https://docs.xbox.com/zh-CN/reference/system/xmem/functions/xmemfree_routine.md)
