Pular para o conteúdo principal

PIXRecordMemoryAllocationEvent

Registra um evento de alocação de memória.

Sintaxe

Parâmetros

allocatorId
Tipo: USHORT
Uma ID que você pode usar para identificar grupos de alocações de memória no criador de perfil de memória. Por exemplo, se você tiver heaps diferentes para itens como gráficos, áudio e física, poderá atribuir a cada uma dessas categorias um allocatorID diferente, para que sejam fáceis de identificar ao exibir uma captura de memória no PIX. baseAddress
Tipo: void*
O endereço inicial da memória que foi alocada. size
Tipo: size_t
O tamanho, em bytes, da memória que foi alocada. metadata
Tipo: UINT64
Um inteiro sem sinal de 64 bits que você pode usar para marcar uma alocação com dados adicionais. Esses dados extras são exibidos no PIX em uma coluna UserData. Você pode usar esses dados extras para identificar o tipo de objeto do seu título armazenado em determinado local de memória, por exemplo.

Valor retornado

Tipo: void

Comentários

Um evento de rastreamento de memória do PIX fornece os dados de que o PIX precisa para exibir informações sobre todas as alocações e liberações de memória feitas pelos alocadores de memória personalizados do título em capturas de criação de perfil de memória. Ao fornecer esses dados, o PIX mostrará, para seus alocadores personalizados, os mesmos dados que mostra para chamadas a VirtualAlloc/VirtualFree e HeapAlloc/HeapFree. Se houver muitos eventos ocorrendo ao mesmo tempo ou se o sistema estiver sob carga pesada, eventos de memória poderão ser perdidos pelo Rastreamento de Eventos para Windows (ETW). A perda de eventos resultará em uma análise incompleta dos dados. A interface do usuário de captura de memória do PIX exibirá um aviso indicando a perda de eventos. Várias chamadas a PIXRecordMemoryFreeEvent podem ser usadas para rastrear memória liberada progressivamente de uma única alocação. Consulte Alocadores de memória personalizados do PIX (tópico sob NDA) para obter informações sobre como os dados de alocações e liberações personalizadas são mostrados em capturas de memória.

Requisitos

Cabeçalho: pixmemory.h Biblioteca: pixevt.lib Plataformas compatíveis: consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

PIX (tópico sob NDA) Alocadores de memória personalizados do PIX (tópico sob NDA) Referência da API do PIX PIXRecordMemoryFreeEvent
Última modificação em 6 de outubro de 2026