> ## 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_FREE_ROUTINE callback

> PHEAP_TRACK_FREE_ROUTINE callback

# PHEAP\_TRACK\_FREE\_ROUTINE callback

힙 할당 해제에 대한 추적 콜백 함수를 나타냅니다.

## 구문

```cpp theme={null}
void PHEAP_TRACK_FREE_ROUTINE(  
         HANDLE Heap,  
         DWORD flags,  
         PVOID addr  
)  
```

### 매개 변수

*Heap*   \
형식: HANDLE

메모리 블록이 해제된 힙에 대한 핸들입니다.

*flags*   \
형식: DWORD

[HeapFree](https://learn.microsoft.com/windows/desktop/api/heapapi/nf-heapapi-heapfree)에 전달된 힙 해제 옵션입니다.

*addr*   \
형식: PVOID

해제된 메모리 블록의 주소입니다.

### 반환 값

형식: void

없음.

## 설명

이 콜백 함수를 구현하여 [HeapAlloc](https://learn.microsoft.com/windows/desktop/api/heapapi/nf-heapapi-heapalloc) 또는 [HeapRealloc](https://learn.microsoft.com/windows/desktop/api/heapapi/nf-heapapi-heaprealloc) 함수로 이전에 할당된 메모리 블록이 Win32 힙에서 해제되는 시점을 추적할 수 있습니다. 구현한 후에는 [XMemSetWin32HeapTrackingHooks](https://docs.xbox.com/ko/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md)를 호출하여 구현한 콜백 함수를 등록해야 합니다. 그런 다음 Win32 힙에서 할당된 메모리 블록을 해제하기 위해 `HeapFree`가 호출된 후 콜백 함수가 호출됩니다. 이 콜백 함수 구현에 대한 자세한 내용은 `XMemSetWin32HeapTrackingHooks`의 [설명](https://docs.xbox.com/ko/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md#remarksSection) 섹션을 참조하세요.

## 요구 사항

**헤더:** xmem.h

**라이브러리:** xmem.lib

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[진단 및 메모리 추적](https://docs.xbox.com/ko/build/console-features/memory/system-memory-diagnostics.md)\
[XMemCreateWin32Heap](https://docs.xbox.com/ko/reference/system/xmem/functions/xmemcreatewin32heap.md)\
[PHEAP\_TRACK\_ALLOC\_ROUTINE](https://docs.xbox.com/ko/reference/system/xmem/functions/pheap_track_alloc_routine.md)\
[PHEAP\_TRACK\_REALLOC\_ROUTINE](https://docs.xbox.com/ko/reference/system/xmem/functions/pheap_track_realloc_routine.md)\
[XMem](https://docs.xbox.com/ko/reference/system/xmem/xmem_members.md)


## Related topics

- [PHEAP_TRACK_REALLOC_ROUTINE callback](https://docs.xbox.com/ko/reference/system/xmem/functions/pheap_track_realloc_routine.md)
- [PHEAP_TRACK_ALLOC_ROUTINE callback](https://docs.xbox.com/ko/reference/system/xmem/functions/pheap_track_alloc_routine.md)
- [XMemSetWin32HeapTrackingHooks](https://docs.xbox.com/ko/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md)
- [XMEMFREE_ROUTINE callback](https://docs.xbox.com/ko/reference/system/xmem/functions/xmemfree_routine.md)
- [XMEMALLOC_ROUTINE callback](https://docs.xbox.com/ko/reference/system/xmem/functions/xmemalloc_routine.md)