_CrtMemDumpAllObjectsSince
Mencadangkan informasi tentang objek dalam timbunan 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 timbunan dalam bentuk yang dapat dibaca pengguna. Informasi cadangan dapat digunakan oleh aplikasi untuk melacak alokasi dan mendeteksi masalah memori. Jika _DEBUG
tidak ditentukan, panggilan ke _CrtMemDumpAllObjectsSince
akan dihapus selama praproscesing.
_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 cadangan yang disediakan aplikasi. Secara default, blok run-time C internal (_CRT_BLOCK
) tidak disertakan dalam operasi cadangan memori. Fungsi _CrtSetDbgFlag
ini 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 timbunan dasar, lihat detail timbunan debug CRT.
Persyaratan
Rutin | Header yang diperlukan |
---|---|
_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
.