_CrtMemDumpAllObjectsSince
Записывает в дамп сведения об объектах в куче с начала выполнения программы или перехода в указанное состояние кучи (только в отладочной версии).
Синтаксис
void _CrtMemDumpAllObjectsSince(
const _CrtMemState *state
);
Параметры
state
Указатель на состояние кучи для начала дампа из или NULL.
Замечания
Функция _CrtMemDumpAllObjectsSince помещает в дамп данные заголовка отладки для выделенных в куче объектов в понятной пользователю форме. Данные дампа могут использоваться приложением для отслеживания операций выделения памяти и выявления проблем с памятью. Если _DEBUG это не определено, вызовы _CrtMemDumpAllObjectsSince удаляются во время предварительной обработки.
_CrtMemDumpAllObjectsSince использует значение параметра state для определения места, с которого должна начинаться операция дампа. Чтобы начать дамп из указанного состояния кучи, state параметр должен быть указателем на _CrtMemState структуру, заполненную _CrtMemCheckpoint до _CrtMemDumpAllObjectsSince вызова. Когда state это NULLтак, функция начинает дамп с начала выполнения программы.
Если приложение установило функцию перехватчика дампа путем вызова _CrtSetDumpClient, то каждый раз _CrtMemDumpAllObjectsSince при дампах сведений о _CLIENT_BLOCK типе блока он также вызывает функцию дампа, предоставляемую приложением. По умолчанию внутренние блоки времени выполнения C (_CRT_BLOCK) не включаются в операции дампа памяти. Функцию _CrtSetDbgFlag можно использовать для включения _CRTDBG_CHECK_CRT_DF бита _crtDbgFlag этих блоков. Кроме того, блоки, помеченные как освобожденные или игнорируемые (_FREE_BLOCK, _IGNORE_BLOCK), не включаются в дамп памяти.
Дополнительные сведения о функциях состояния кучи и _CrtMemState структуре см. в разделе "Отчеты о состоянии кучи". Дополнительные сведения о выделении, инициализации и управлении блоками памяти в отладочной версии базовой кучи см. в сведениях об отладочной куче CRT.
Требования
| Маршрут | Обязательный заголовок |
|---|---|
| _CrtMemDumpAll-ObjectsSince | <crtdbg.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость.
Библиотеки
Только отладочные версии библиотек времени выполнения языка C.
Пример
Пример использования _CrtMemDumpAllObjectsSinceсм. в разделе crt_dbg2.