_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.