Skip to main content

PIXRecordMemoryAllocationEvent

Registra un evento de asignación de memoria.

Sintaxis

Parámetros

allocatorId
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
Tipo: void*
La dirección inicial de la memoria que se ha asignado. size
Tipo: size_t
El tamaño de la memoria que se ha asignado, en bytes. metadata
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 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) 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

Consulte también

PIX (tema NDA) Asignadores de memoria personalizados de PIX (tema NDA) Referencia de API de PIX PIXRecordMemoryFreeEvent
Última modificación el 28 de agosto de 2026