_CrtMemDumpStatistics
Gibt die Debugheaderinformationen für einen angegebenen Heapzustand in einer für den Benutzer lesbaren Form aus (nur Debugversion).
void _CrtMemDumpStatistics(
const _CrtMemState *state
);
Parameter
- state
Zeiger zum auszugebenden Heapzustand.
Hinweise
Die _CrtMemDumpStatistics-Funktion gibt die Debugheaderinformationen für einen angegebenen Zustand des Heaps in einer für den Benutzer lesbaren Form aus. Die Dumpstatistik kann von der Anwendung zum Nachverfolgen von Zuordnungen und zum Erkennen von Speicherproblemen verwendet werden. Der Speicherzustands kann einen bestimmten Heapzustand oder den Unterschied zwischen zwei Zuständen enthalten. Wenn _DEBUG nicht definiert ist, werden Aufrufe von _CrtMemDumpStatistics während der Vorverarbeitung entfernt.
Der state-Parameter muss ein Zeiger zu einer _CrtMemState-Struktur sein, die von _CrtMemCheckpoint gefüllt oder von _CrtMemDifference zurückgegeben wurden, bevor _CrtMemDumpStatistics aufgerufen wird. Wenn state den Wert NULL annimmt, wird der ungültige Parameterhandler, wie in Parametervalidierung beschrieben, aufgerufen. Wenn die weitere Ausführung zugelassen wird, wird errno auf EINVAL gesetzt und keine Aktion durchgeführt. Weitere Informationen finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr.
Weitere Informationen über Heapzustandsfunktionen und die _CrtMemState-Struktur finden Sie unter Berichtsfunktionen für den Heapzustand. Weitere Informationen darüber, wie Speicherblöcke in der Debugversion des Basisheaps zugeordnet, initialisiert und verwaltet werden, finden Sie unter Details zum CRT-Debugheap.
Anforderungen
Routine |
Erforderlicher Header |
Optionale Header |
|---|---|---|
_CrtMemDumpStatistics |
<crtdbg.h> |
<errno.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken: nur Debugversionen von CRT-Bibliotheksfunktionen.
Beispiel
Siehe crt_dbg1.