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

# PIXRecordMemoryAllocationEvent

> PIXRecordMemoryAllocationEvent

# PIXRecordMemoryAllocationEvent

Registra un evento de asignación de memoria.

## Sintaxis

```cpp theme={null}
void PIXRecordMemoryAllocationEvent(  
         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 asignado.

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

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

*metadata*   <br />Tipo: UINT64

Entero sin signo de 64 bits que puede usar para etiquetar una asignación 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 está almacenado en una ubicación de memoria determinada.

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

Si se producen muchos 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.

Se pueden usar varias llamadas a [PIXRecordMemoryFreeEvent](/reference/tools/pix3/functions/pixrecordmemoryfreeevent) para realizar el seguimiento de la memoria que se libera progresivamente a partir de una única asignación.

Consulte [Asignadores de memoria personalizados de PIX (tema NDA)](/tools/tools-console/pix/pix-custom-memory-allocators) para obtener información sobre cómo se muestran en las capturas de memoria los datos de las asignaciones y liberaciones personalizadas.

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

[PIX (tema NDA)](/tools/tools-console/pix/pix)

[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)

[PIXRecordMemoryFreeEvent](/reference/tools/pix3/functions/pixrecordmemoryfreeevent)


## Related topics

- [PIXRecordMemoryFreeEvent](/es/reference/tools/pix3/functions/pixrecordmemoryfreeevent.md)
- [PIX3](/es/reference/tools/pix3/pix3_members.md)
- [DSTORAGE_ERROR_RECORD](/es/reference/system/dstorage/structs/dstorage_error_record.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [XMEM_ALLOCATION_HOOKS](/es/reference/system/xmem/structs/xmem_allocation_hooks.md)