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

# Retorno de chamada PHEAP_TRACK_FREE_ROUTINE

> Retorno de chamada PHEAP_TRACK_FREE_ROUTINE

# Retorno de chamada PHEAP\_TRACK\_FREE\_ROUTINE

Representa uma função de retorno de chamada de rastreamento para desalocação de heap.

## Sintaxe

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

### Parâmetros

*Heap*   \
Tipo: HANDLE

O identificador do heap do qual o bloco de memória foi liberado.

*flags*   \
Tipo: DWORD

As opções de liberação de heap passadas para [HeapFree](https://learn.microsoft.com/windows/desktop/api/heapapi/nf-heapapi-heapfree).

*addr*   \
Tipo: PVOID

O endereço do bloco de memória que foi liberado.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

Essa função de retorno de chamada pode ser implementada para rastrear quando um bloco de memória alocado anteriormente pela função [HeapAlloc](https://learn.microsoft.com/windows/desktop/api/heapapi/nf-heapapi-heapalloc) ou [HeapRealloc](https://learn.microsoft.com/windows/desktop/api/heapapi/nf-heapapi-heaprealloc) é liberado de um heap Win32. Depois de implementá-la, você deve registrar a função de retorno de chamada implementada chamando [XMemSetWin32HeapTrackingHooks](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md). A função de retorno de chamada é então invocada depois que `HeapFree` é chamada para liberar um bloco de memória alocado de um heap Win32. Para obter mais informações sobre como implementar essa função de retorno de chamada, consulte a seção [Comentários](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md#remarksSection) de `XMemSetWin32HeapTrackingHooks`.

## Requisitos

**Cabeçalho:** xmem.h

**Biblioteca:** xmem.lib

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Diagnóstico e rastreamento de memória](https://docs.xbox.com/pt-BR/build/console-features/memory/system-memory-diagnostics.md)\
[XMemCreateWin32Heap](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemcreatewin32heap.md)\
[PHEAP\_TRACK\_ALLOC\_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/pheap_track_alloc_routine.md)\
[PHEAP\_TRACK\_REALLOC\_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/pheap_track_realloc_routine.md)\
[XMem](https://docs.xbox.com/pt-BR/reference/system/xmem/xmem_members.md)


## Related topics

- [XMemSetWin32HeapTrackingHooks](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemsetwin32heaptrackinghooks.md)
- [Retorno de chamada PHEAP_TRACK_ALLOC_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/pheap_track_alloc_routine.md)
- [Retorno de chamada PHEAP_TRACK_REALLOC_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/pheap_track_realloc_routine.md)
- [Retorno de chamada XMEMFREE_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemfree_routine.md)
- [Retorno de chamada XMEMALLOC_ROUTINE](https://docs.xbox.com/pt-BR/reference/system/xmem/functions/xmemalloc_routine.md)