> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PIXRecordMemoryFreeEvent

> PIXRecordMemoryFreeEvent

# PIXRecordMemoryFreeEvent

Registra un evento de liberación de memoria.

## Sintaxis

```cpp theme={null}
void PIXRecordMemoryFreeEvent(  
         USHORT allocatorId,  
         void* baseAddress,  
         size_t size,  
         UINT64 metadata  
)  
```

### Parámetros

*allocatorId*   <br />Tipo: USHORT

Identificador que puede usar para identificar grupos de asignaciones de memoria en el generador de perfiles de memoria. Por ejemplo, si tiene montones diferentes para elementos como gráficos, audio y físicas, puede asignar a cada una de estas categorías un allocatorID diferente para que sean fáciles de identificar al ver una captura de memoria en PIX.

*baseAddress*   <br />Tipo: void\*

La dirección inicial de la memoria que se ha liberado.

*size*   <br />Tipo: size\_t

El tamaño de la memoria que se ha liberado, en bytes.

*metadata*   <br />Tipo: UINT64

Entero sin signo de 64 bits que puede usar para etiquetar una liberación de memoria con datos adicionales. Estos datos adicionales se muestran en PIX en una columna UserData. Puede usar estos datos adicionales para identificar, por ejemplo, el tipo de objeto de su título que se ha liberado en una ubicación de memoria determinada. El valor pasado a `PIXRecordMemoryFreeEvent` no tiene que coincidir con el valor pasado a la llamada correspondiente a [PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/pixrecordmemoryallocationevent).

### Valor devuelto

Tipo: void

## Comentarios

Un evento de seguimiento de memoria de PIX proporciona los datos que PIX necesita para mostrar información sobre todas las asignaciones y liberaciones de memoria realizadas desde los asignadores de memoria personalizados del título en las capturas de generación de perfiles de memoria. Al proporcionar estos datos, PIX mostrará para sus asignadores personalizados los mismos datos que muestra para las llamadas a `VirtualAlloc/VirtualFree` y `HeapAlloc/HeapFree`.

PIX usa los parámetros *baseAddress* y *size* para localizar la asignación correspondiente de la siguiente manera: si *baseAddress* coincide con el *baseAddress* pasado a la llamada correspondiente a [PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/pixrecordmemoryallocationevent), PIX emparejará la asignación y la liberación simplemente comparando las direcciones. En este caso, se puede pasar 0 en el parámetro *size*. Si *baseAddress* es diferente del valor especificado en la asignación correspondiente, el parámetro *size* debe especificarse como distinto de cero. En este caso, PIX encontrará las asignaciones correspondientes usando tanto *baseAddress* como *size*.

Si se produce un gran número de eventos al mismo tiempo o el sistema está sometido a una carga elevada, el Seguimiento de eventos para Windows (ETW) puede perder eventos de memoria. La pérdida de eventos dará lugar a un análisis incompleto de los datos. La interfaz de usuario de captura de memoria de PIX mostrará una advertencia que indica la pérdida de eventos.

## Requisitos

**Encabezado:** pixmemory.h

**Biblioteca:** pixevt.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Lista de comprobación de interacción con sistemas de ATG](/build/atg-engagement/atg-systems-engagement)

## Consulte también

[Asignadores de memoria personalizados de PIX (tema NDA)](/tools/tools-console/pix/pix-custom-memory-allocators) [Referencia de API de PIX](/reference/tools/pix3/pix3_members)<br />[PIXRecordMemoryAllocationEvent](/reference/tools/pix3/functions/pixrecordmemoryallocationevent)<br />[PIX (tema NDA)](/tools/tools-console/pix/pix)


## Related topics

- [PIXRecordMemoryAllocationEvent](/es/reference/tools/pix3/functions/pixrecordmemoryallocationevent.md)
- [PIX3](/es/reference/tools/pix3/pix3_members.md)
- [game_chat_free_memory_callback](/es/reference/chat/gamechat2/functions/game_chat_free_memory_callback.md)
- [PartyFreeMemoryCallback](/es/services/playfab/multiplayer/networking/reference/callbacks/partyfreememorycallback.md)
- [PFMultiplayerFreeMemoryCallback](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/callbacks/pfmultiplayerfreememorycallback.md)