_CrtMemDumpStatistics

Vide les informations d’en-tête de débogage pour l’état du tas spécifié sous une forme lisible par l’utilisateur (version Debug uniquement).

Syntaxe

void _CrtMemDumpStatistics(
   const _CrtMemState *state
);

Paramètres

state
Pointeur vers l’état du tas à vider.

Notes

La fonction _CrtMemDumpStatistics vide les informations d’en-tête de débogage pour l’état du tas spécifié sous une forme lisible par l’utilisateur. Les statistiques de vidage permettent à l’application d’effectuer le suivi des allocations, et de détecter les problèmes de mémoire. L’état de la mémoire peut contenir un état de tas spécifique, ou la différence entre deux états. Quand _DEBUG n’est pas défini, les appels à _CrtMemDumpStatistics sont supprimés lors du prétraitement.

Le paramètre state doit être un pointeur vers une structure _CrtMemState remplie par _CrtMemCheckpoint ou retournée par _CrtMemDifference avant l’appel de _CrtMemDumpStatistics. 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 prend la valeur EINVAL et aucune action n’est retournée. Pour plus d'informations, voir errno, _doserrno, _sys_errlist et _sys_nerr.

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.

Spécifications

Routine	En-tête requis	En-têtes facultatifs
_CrtMemDumpStatistics	<crtdbg.h>	<errno.h>

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

Bibliothèques : uniquement les versions de débogage des bibliothèques Runtime C.

Voir aussi

Routines de débogage