_CrtMemCheckpoint

Obtient l'état actuel du tas de débogage et le stocke dans une structure _CrtMemState fournie par l'application (version debug uniquement).

Syntaxe

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Paramètres

state
Pointeur vers la structure _CrtMemState à remplir avec le point de contrôle de mémoire.

Notes

La fonction _CrtMemCheckpoint crée un instantané de l'état actuel du tas de débogage à tout moment donné. Cette instantané peut être utilisée par d’autres fonctions d’état de tas, comme _CrtMemDifference pour aider à détecter les fuites de mémoire et d’autres problèmes. Quand _DEBUG elle n’est pas définie, les appels à supprimer _CrtMemState pendant le prétraitement.

L'application doit passer un pointeur vers une instance précédemment allouée de la structure _CrtMemState , définie dans Crtdbg.h, dans le paramètre state . Si _CrtMemCheckpoint rencontre une erreur pendant la création du point de contrôle, la fonction génère un rapport de débogage _CRT_WARN qui décrit le problème.

Pour plus d’informations sur les fonctions d’état du tas et la _CrtMemState structure, consultez fonctions de création de rapports d’état de tas. Pour plus d’informations sur la façon dont les blocs de mémoire sont alloués, initialisés et gérés dans la version de débogage du tas de base, consultez les détails du tas de débogage CRT.

Si state c’est NULLle cas, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à continuer, errno, _doserrno, _sys_errlistet est définie EINVAL sur et_sys_nerrla fonction retourne.

Spécifications

Routine	En-tête requis
_CrtMemCheckpoint	<crtdbg.h>, <errno.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques : uniquement les versions Debug de la bibliothèque UCRT.

Voir aussi

Routines de débogage
_CrtMemDifference