PIXRecordMemoryFreeEvent
Registra un evento de liberación de memoria.Sintaxis
Parámetros
allocatorIdTipo: 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 liberado. size
Tipo: size_t El tamaño de la memoria que se ha liberado, en bytes. metadata
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.
Valor devuelto
Tipo: voidComentarios
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 aVirtualAlloc/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, 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 SeriesDocumentación conceptual
Consulte también
Asignadores de memoria personalizados de PIX (tema NDA) Referencia de API de PIXPIXRecordMemoryAllocationEvent
PIX (tema NDA)