Skip to main content

PHEAP_TRACK_ALLOC_ROUTINE callback

Represents a tracking callback function for heap allocation.

Syntax

Parameters

Heap   
Type: HANDLE
The handle to the heap from which the memory block was allocated. Flags   
Type: DWORD
The heap allocation flags passed to HeapAlloc. Size   
Type: SIZE_T
The number of bytes allocated for the memory block. Addr   
Type: PVOID
The address of the allocated memory block.

Return value

Type: void None.

Remarks

This callback function can be implemented to track when a memory block is allocated from a Win32 heap. Once implemented, you must register the implemented callback function by calling XMemSetWin32HeapTrackingHooks. The callback function is then invoked after HeapAlloc is called to allocate a block of memory 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_FREE_ROUTINE
PHEAP_TRACK_REALLOC_ROUTINE
XMem
Last modified on August 20, 2026