_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
sie nicht definiert ist, werden die Aufrufe _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 NULL
der Zeitpunkt, beginnt die Funktion mit dem Dump vom Anfang der Programmausführung.
Wenn die Anwendung eine Dump-Hook-Funktion durch Aufrufen _CrtSetDumpClient
installiert 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 zu Heap-Zustandsfunktionen und der _CrtMemState
Struktur finden Sie unter Heap-Statusberichtsfunktionen. Weitere Informationen dazu, wie Speicherblöcke in der Debugversion des Basis heap 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.
Bibliotheken
Nur Debugversionen von C-Laufzeitbibliotheken
Beispiel
Ein Beispiel für die Verwendung _CrtMemDumpAllObjectsSince
finden Sie unter crt_dbg2
.
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für