_CrtMemDumpAllObjectsSince
Membuang informasi tentang objek dalam tumpukan dari awal eksekusi program atau dari status timbunan tertentu (hanya versi debug).
Sintaks
void _CrtMemDumpAllObjectsSince(
const _CrtMemState *state
);
Parameter
state
Penunjuk ke status timbunan untuk mulai mencadangkan dari atau NULL
.
Keterangan
Fungsi ini _CrtMemDumpAllObjectsSince
mencadangkan informasi header debug objek yang dialokasikan dalam heap dalam bentuk yang dapat dibaca pengguna. Informasi cadangan dapat digunakan oleh aplikasi untuk melacak alokasi dan mendeteksi masalah memori. Ketika _DEBUG
tidak ditentukan, panggilan ke _CrtMemDumpAllObjectsSince
akan dihapus selama praproscessing.
_CrtMemDumpAllObjectsSince
menggunakan nilai state
parameter untuk menentukan tempat memulai operasi pencadangan. Untuk mulai mencadangkan dari status timbunan tertentu, state
parameter harus menjadi penunjuk ke _CrtMemState
struktur yang telah diisi oleh _CrtMemCheckpoint
sebelumnya _CrtMemDumpAllObjectsSince
dipanggil. Ketika state
adalah NULL
, fungsi memulai dump dari awal eksekusi program.
Jika aplikasi telah menginstal fungsi dump hook dengan memanggil _CrtSetDumpClient
, maka setiap kali _CrtMemDumpAllObjectsSince
membuang informasi tentang _CLIENT_BLOCK
jenis blok, aplikasi juga memanggil fungsi dump yang disediakan aplikasi. Secara default, blok run-time C internal (_CRT_BLOCK
) tidak disertakan dalam operasi cadangan memori. Fungsi ini _CrtSetDbgFlag
dapat digunakan untuk mengaktifkan _CRTDBG_CHECK_CRT_DF
bit _crtDbgFlag
untuk menyertakan blok-blok ini. Selain itu, blok yang ditandai sebagai dibebaskan atau diabaikan (_FREE_BLOCK
, _IGNORE_BLOCK
) tidak disertakan dalam cadangan memori.
Untuk informasi selengkapnya tentang fungsi status timbunan dan _CrtMemState
struktur, lihat Fungsi pelaporan status timbunan. Untuk informasi selengkapnya tentang bagaimana blok memori dialokasikan, diinisialisasi, dan dikelola dalam versi debug dari timbunan dasar, lihat detail timbunan debug CRT.
Persyaratan
Rutin | Header yang dibutuhkan |
---|---|
_CrtMemDumpAll-ObjectsSince | <crtdbg.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Pustaka
Debug versi pustaka run-time C saja.
Contoh
Untuk sampel cara menggunakan _CrtMemDumpAllObjectsSince
, lihat crt_dbg2
.