_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.

Требования

Дополнительные сведения о совместимости см. в разделе Совместимость.

Библиотеки

Только отладочные версии библиотек времени выполнения языка C.

Пример

Пример использования _CrtMemDumpAllObjectsSinceсм. в разделе crt_dbg2.

См. также

Отладка подпрограмм
_crtDbgFlag