_CrtMemCheckpoint

 

Date de publication : novembre 2016

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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.

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 aider à 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 sur la structure _CrtMemState , consultez Heap State Reporting Functions. 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 Debug du tas de base, consultez CRT Debug Heap Details.

Si state est 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 est défini sur EINVAL et la fonction retourne.

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

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

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

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

Routines de débogage
_CrtMemDifference

Afficher: