Skip to main content

PHEAP_TRACK_FREE_ROUTINE callback

Represents a tracking callback function for heap de-allocation.

Syntax

Parameters

Heap   
Type: HANDLE
The handle to the heap from which the memory block was freed. flags   
Type: DWORD
The heap free options passed to HeapFree. addr   
Type: PVOID
The address of the memory block that was freed.

Return value

Type: void None.

Remarks

This callback function can be implemented to track when a memory block previously allocated by the HeapAlloc or HeapRealloc function is freed from a Win32 heap. Once implemented, you must register the implemented callback function by calling XMemSetWin32HeapTrackingHooks. The callback function is then invoked after HeapFree is called to free an allocated memory block from a Win32 heap. For more information about implementing this callback function, see the Remarks section of XMemSetWin32HeapTrackingHooks.

Requirements

Header: xmem.h Library: xmem.lib Supported platforms: XBOX One family consoles and XBOX Series consoles

See also

Diagnostics and memory tracking
XMemCreateWin32Heap
PHEAP_TRACK_ALLOC_ROUTINE
PHEAP_TRACK_REALLOC_ROUTINE
XMem
Last modified on August 20, 2026