_CrtMemDumpStatistics
Gibt die Debugheaderinformationen für einen angegebenen Heapzustand in einer für den Benutzer lesbaren Form aus (nur Debugversion).
Syntax
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 auf eine _CrtMemState-Struktur sein, die von _CrtMemCheckpoint gefüllt oder von _CrtMemDifference zurückgegeben wurden, bevor _CrtMemDumpStatistics aufgerufen wird. Wenn state den Wert NULLannimmt, wird der Handler für ungültige Parameter aufgerufen, wie in Parameter Validation. Wenn die weitere Ausführung zugelassen wird, wird errno auf EINVAL gesetzt und keine Aktion durchgeführt. Weitere Informationen finden Sie untererrno, _doserrno, _sys_errlistund _sys_nerr.
Weitere Informationen über Heapzustandsfunktionen und die _CrtMemState-Struktur finden Sie unter Heap State Reporting Functions. Weitere Informationen darüber, wie Speicherblöcke in der Debugversion des Basisheaps zugeordnet, initialisiert und verwaltet werden, finden Sie unter CRT Debug Heap Details.
Anforderungen
| Routine | Erforderlicher Header | Optionale Header |
|---|---|---|
_CrtMemDumpStatistics |
<crtdbg.h> | <errno.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Bibliotheken: Nur Debugversionen der C-Laufzeitbibliotheken.