_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. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.