_CrtMemCheckpoint
Obtient l'état actuel du tas de débogage et les stocke dans une structure fournie par l'application d' _CrtMemState (version debug uniquement).
void _CrtMemCheckpoint(
_CrtMemState *state
);
Paramètres
- state
Pointeur vers la structure d' _CrtMemState à la remplir avec le point de contrôle de mémoire.
Notes
la fonction d' _CrtMemCheckpoint crée un instantané de l'état actuel du tas de débogage à tout moment.Cet instantané peut être utilisé par d'autres fonctions d'état du tas telles que _CrtMemCheckpoint pour faciliter la détection des fuites de mémoire et des autres problèmes.Lorsque _DEBUG n'est pas défini, les appels à _CrtMemState sont supprimés pendant le prétraitement.
L'application doit passer un pointeur vers une instance précédemment allouée de la structure d' _CrtMemState , définie dans Crtdbg.h, dans le paramètre d' state .Si _CrtMemCheckpoint rencontre une erreur lors de la création du point de contrôle, la fonction génère un rapport de débogage d' _CRT_WARN décrivant le problème.
Pour plus d'informations sur les fonctions d'état du tas et la structure d' _CrtMemState , consultez 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 debug de tas de base, consultez Gestion de la mémoire et tas de débogage.
si state est NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, errno, _doserrno, _sys_errlist, et _sys_nerr est défini à EINVAL et la fonction.
Configuration requise
routine |
en-tête requis |
|---|---|
_CrtMemCheckpoint |
<crtdbg.h> , <errno.h> |
Pour plus d'informations de compatibilité, consultez Compatibilité dans l'introduction.
bibliothèques : Versions debug de Fonctionnalités de bibliothèque CRT uniquement.
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é.