Partager via


_CrtMemCheckpoint

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

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é. Cet instantané peut être utilisé par d'autres fonctions d'état du tas comme _CrtMemDifference pour mieux détecter les fuites de mémoire et d'autres problèmes. Quand _DEBUG n'est pas défini, les appels à _CrtMemState sont supprimés lors du 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 structure _CrtMemState, voir Fonctions de création de rapports sur l'état du 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, voir Détails du tas de débogage CRT.

Si state a la valeur NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, errno, _doserrno, _sys_errlist et _sys_nerr a la valeur EINVAL et la fonction retourne une valeur.

Configuration requise

Routine

En-tête requis

_CrtMemCheckpoint

<crtdbg.h>, <errno.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.

Bibliothèques : uniquement les versions de débogage des Fonctions des bibliothèque CRT.

Exemple

Consultez crt_dbg1.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de code non managé.

Voir aussi

Référence

Routines de débogage

_CrtMemDifference