_CrtMemDumpAllObjectsSince
Gibt Informationen zu Objekten im Heap ab Beginn der Programmausführung oder ab einem angegebenen Heapzustand aus (nur Debugversion).
Syntax
void _CrtMemDumpAllObjectsSince(
const _CrtMemState *state
);
Parameter
state
Zeigen Sie auf den Heap-Zustand, um mit dem Dumping von oder NULL.
Hinweise
Die _CrtMemDumpAllObjectsSince-Funktion gibt die Debugheaderinformationen von Objekten, die im Heap zugeordnet sind, in einer für den Benutzer lesbaren Formular aus. Die Dumpinformationen können von der Anwendung zum Nachverfolgen von Zuordnungen und zum Erkennen von Speicherproblemen verwendet werden. Wenn _DEBUG nicht definiert ist, werden Aufrufe von _CrtMemDumpAllObjectsSince während der Vorverarbeitung entfernt.
_CrtMemDumpAllObjectsSince verwendet den Wert des state-Parameters, um zu ermitteln, wo der Dumpvorgang initiiert werden soll. Um mit dem Dumping aus einem angegebenen Heap-Zustand zu beginnen, muss der state Parameter ein Zeiger auf eine _CrtMemState Struktur sein, die vor _CrtMemCheckpoint dem _CrtMemDumpAllObjectsSince Aufruf ausgefüllt wurde. Ist state dies NULLder Zeitpunkt, beginnt die Funktion mit dem Dump vom Anfang der Programmausführung.
Wenn die Anwendung eine Dump-Hook-Funktion durch Aufrufen _CrtSetDumpClientinstalliert hat, ruft sie jedes Mal, wenn _CrtMemDumpAllObjectsSince Informationen zu einem _CLIENT_BLOCK Blocktyp abbilden, auch die von der Anwendung bereitgestellte Dumpfunktion auf. Standardmäßig sind interne C-Laufzeitblöcke (_CRT_BLOCK) nicht in Speicherabbildvorgängen enthalten. Die _CrtSetDbgFlag Funktion kann zum Aktivieren des _CRTDBG_CHECK_CRT_DF Bits _crtDbgFlag verwendet werden, um diese Blöcke einzuschließen. Darüber hinaus sind Blöcke, die als freigegeben oder ignoriert gekennzeichnet sind (_FREE_BLOCK, _IGNORE_BLOCK) nicht im Speicherabbild enthalten.
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 |
|---|---|
| _CrtMemDumpAll-ObjectsSince | <crtdbg.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Libraries
Nur Debugversionen von C-Laufzeitbibliotheken
Beispiel
Ein Beispiel für die Verwendung _CrtMemDumpAllObjectsSincefinden Sie unter crt_dbg2.