XMemSetWin32HeapTrackingHooks

Define funções de retorno de chamada de rastreamento para alocação, realocação e desalocação de memória de heaps do Win32.

Sintaxe

VOID XMemSetWin32HeapTrackingHooks(  
         PHEAP_TRACK_ALLOC_ROUTINE AllocRoutine,  
         PHEAP_TRACK_REALLOC_ROUTINE ReAllocRoutine,  
         PHEAP_TRACK_FREE_ROUTINE FreeRoutine  
)  

Parâmetros

AllocRoutine   _In_
Tipo: PHEAP_TRACK_ALLOC_ROUTINE Um ponteiro para uma função de retorno de chamada de rastreamento para alocação de memória. ReAllocRoutine   _In_
Tipo: PHEAP_TRACK_REALLOC_ROUTINE Um ponteiro para uma função de retorno de chamada de rastreamento para realocação de memória. FreeRoutine   _In_
Tipo: PHEAP_TRACK_FREE_ROUTINE Um ponteiro para uma função de retorno de chamada de rastreamento para desalocação de memória.

Valor retornado

Tipo: VOID Nenhum.

Comentários

Essa função permite rastrear a alocação, realocação e desalocação de memória de heap do Win32 especificando funções de retorno de chamada que são invocadas pelo gerenciador de memória do GDK quando essas operações de memória de heap são chamadas. Para obter mais informações sobre o rastreamento de operações de memória, consulte Diagnóstico e rastreamento de memória.

O CRT faz várias alocações de heap durante a inicialização e nos pontos de entrada de DLLs/EXEs vinculados ao CRT. Como essa inicialização é um pré-requisito para a execução de qualquer código nesses módulos, normalmente não é possível chamar XMemSetWin32HeapTrackingHooks antes que todas as alocações de heap ocorram. O código de retorno de chamada deve estar ciente desse comportamento e tratá-lo adequadamente.

Antes de chamar essa função, você deve primeiro implementar as seguintes funções de retorno de chamada de rastreamento correspondentes:

Para rastrear a alocação quando HeapAlloc for invocado, implemente uma função de retorno de chamada PHEAP_TRACK_ALLOC_ROUTINE.
Para rastrear a realocação quando HeapReAlloc for invocado, implemente uma função de retorno de chamada PHEAP_TRACK_REALLOC_ROUTINE.
Para rastrear a desalocação quando HeapFree for invocado, implemente uma função de retorno de chamada PHEAP_TRACK_FREE_ROUTINE.

Você só precisa implementar as funções de retorno de chamada de rastreamento necessárias para seus requisitos de rastreamento. Para interromper o rastreamento de operações de memória de heap, chame essa função e especifique NULL para as operações de memória de heap apropriadas que você deseja parar de rastrear. O exemplo a seguir define funções de retorno de chamada de rastreamento e, em seguida, usa a função XMemSetWin32HeapTrackingHooks para definir e limpar ganchos para essas funções de retorno de chamada de rastreamento.

void OnHeapAlloc(HANDLE hHeap, DWORD flags, SIZE_T size, PVOID addr)
{
    DebugPrint("[Heap 0x%p] Alloc %I64d bytes at addr: %p\n",
               hHeap, size, addr);
}

void OnHeapRealloc(HANDLE hHeap, DWORD flags, SIZE_T size, PVOID oldAddr, PVOID newAddr)
{
    DebugPrint("[Heap 0x%p] ReAlloc addr: 0x%p to %I64d bytes (new addr: 0x%p)\n",
               hHeap, oldAddr, size, newAddr);
}

void OnHeapFree(HANDLE hHeap, DWORD flags, PVOID addr)
{
    DebugPrint("[Heap 0x%p] Free addr: 0x%p\n",
               hHeap, addr);
}

// Set Hooks
XMemSetWin32HeapTrackingHooks(OnHeapAlloc, OnHeapReAlloc, OnHeapFree);

// Clear Hooks
XMemSetWin32HeapTrackingHooks(NULL, NULL, NULL);

Requisitos

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

Confira também

Memória
XMem

Porting

Build Paths

XMemSetWin32HeapTrackingHooks

XMemSetWin32HeapTrackingHooks

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também

​XMemSetWin32HeapTrackingHooks

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Requisitos

​Confira também

XMemSetWin32HeapTrackingHooks

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também