Поделиться через


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

Эквивалент в .NET Framework

Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

См. также

Ссылки

Процедуры отладки

_crtDbgFlag