_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é. 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 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, consultez 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 à 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.