_CrtMemCheckpoint
Ottiene lo stato corrente dell'heap di debug e lo memorizza in una struttura _CrtMemState fornita dall'applicazione (solo versione debug).
void _CrtMemCheckpoint( _CrtMemState *state );
Parametri
- state
Puntatore alla struttura _CrtMemState da riempire con il checkpoint di memoria.
Note
La funzione _CrtMemCheckpoint crea uno snapshot dello stato corrente dell'heap di debug in qualsiasi momento. Lo snapshot potrà essere usato da altre funzioni dello stato dell'heap come _CrtMemDifference per aiutare a rilevare perdite di memoria e altri problemi. Quando _DEBUG non è definito, le chiamate a _CrtMemState vengono rimosse durante la pre-elaborazione.
L'applicazione deve passare un puntatore a un'istanza precedentemente allocata della struttura _CrtMemState, definita in Crtdbg.h, nel parametro state. Se _CrtMemCheckpoint incontra un errore durante la creazione del checkpoint, la funzione genera un report di debug _CRT_WARN che descrive il problema.
Per altre informazioni sulle funzioni dello stato dell'heap e sulla struttura _CrtMemState, vedere Funzioni per la creazione di report sullo stato dell'heap. Per altre informazioni sulle modalità di allocazione, inizializzazione e gestione dei blocchi di memoria nella versione di debug dell'heap di base, vedere Informazioni dettagliate sull'heap di debug CRT.
Se state è NULL, sarà richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno, _doserrno, _sys_errlist, and _sys_nerr viene impostato su EINVAL e viene restituito il risultato della funzione.
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_CrtMemCheckpoint |
<crtdbg.h>, <errno.h> |
Per altre informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
Librerie: solo versioni di debug di Funzionalità libreria CRT.
Esempio
Vedere crt_dbg1.
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione C standard, usare PInvoke. Per altre informazioni, vedere Esempi di platform invoke.