_CrtMemDumpAllObjectsSince
Esegue il dump delle informazioni sugli oggetti nell'heap dall'inizio dell'esecuzione del programma o da uno stato di heap specificato (solo versione di debug).
Sintassi
void _CrtMemDumpAllObjectsSince(
const _CrtMemState *state
);
Parametri
state
Puntatore allo stato dell'heap per iniziare il dump da o NULL
.
Osservazioni:
La funzione _CrtMemDumpAllObjectsSince
esegue il dump delle informazioni di intestazione di debug degli oggetti allocati nell'heap in un formato leggibile dall'utente. Le informazioni di dump possono essere usate dall'applicazione per tenere traccia delle allocazioni e per rilevare problemi di memoria. Quando _DEBUG
non è definito, le chiamate a _CrtMemDumpAllObjectsSince
vengono rimosse durante la pre-elaborazione.
_CrtMemDumpAllObjectsSince
usa il valore del parametro state
per determinare il punto in cui avviare l'operazione di dump. Per iniziare il dump da uno stato dell'heap specificato, il state
parametro deve essere un puntatore a una _CrtMemState
struttura compilata da _CrtMemCheckpoint
prima _CrtMemDumpAllObjectsSince
della chiamata. Quando state
è NULL
, la funzione avvia il dump dall'inizio dell'esecuzione del programma.
Se l'applicazione ha installato una funzione hook dump chiamando _CrtSetDumpClient
, ogni volta che _CrtMemDumpAllObjectsSince
esegue il dump di informazioni su un _CLIENT_BLOCK
tipo di blocco, chiama anche la funzione dump fornita dall'applicazione. Per impostazione predefinita, i blocchi di runtime C interni (_CRT_BLOCK
) non sono inclusi nelle operazioni di dump della memoria. La _CrtSetDbgFlag
funzione può essere usata per attivare il _CRTDBG_CHECK_CRT_DF
bit di _crtDbgFlag
per includere questi blocchi. Inoltre, i blocchi contrassegnati come liberati o ignorati (_FREE_BLOCK
, _IGNORE_BLOCK
) non sono inclusi nel dump della memoria.
Per altre informazioni sulle funzioni di stato dell'heap e sulla _CrtMemState
struttura, vedere Funzioni di creazione di report dello stato heap. Per altre informazioni sulla modalità di allocazione, inizializzazione e gestione dei blocchi di memoria nella versione di debug dell'heap di base, vedere Dettagli dell'heap di debug CRT.
Requisiti
Ciclo | Intestazione obbligatoria |
---|---|
_CrtMemDumpAll-ObjectsSince | <crtdbg.h> |
Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).
Librerie
Solo le versioni di debug delle librerie di runtime di C.
Esempio
Per un esempio di come usare _CrtMemDumpAllObjectsSince
, vedere crt_dbg2
.