_CrtMemDumpStatistics
Сбрасывает сведения заголовка отладки для указанного состояния кучи в удобочитаемой для пользователя форме (только отладочную версию).
void _CrtMemDumpStatistics(
const _CrtMemState *state
);
Параметры
- state
Указатель на состояние кучи для сбрасывания.
Заметки
Функция _CrtMemDumpStatistics сбрасывает сведения заголовка отладки для указанного состояния кучи в удобочитаемой для пользователя форме. Статистика дампа может использоваться приложением для отслеживания выделения памяти и обнаружения проблем с ней. Состояние памяти может содержать конкретное состояние кучи или различие между двумя состояниями. Если _DEBUG не определен, то вызовы _CrtMemDumpStatistics удаляются во время предварительной обработки.
Параметр state должен быть указателем на структуру _CrtMemState, которая была заполнена _CrtMemCheckpoint или возвращена _CrtMemDifference до вызова _CrtMemDumpStatistics. Если параметр state имеет значение NULL, вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, errno устанавливается в EINVAL, и никакие действия не предпринимаются. Дополнительные сведения см. в разделе errno, _doserrno, _sys_errlist, and _sys_nerr.
Дополнительные сведения о функциях состояния кучи и о структуре _CrtMemState см. в разделе Функции отчета о состоянии кучи. Дополнительные сведения о том, как происходит выделение, инициализация и управление блоками памяти в отладочной версии базовой кучи см. в разделе Сведения о куче отладки CRT.
Требования
Подпрограмма |
Обязательный заголовок |
Необязательные заголовки |
|---|---|---|
_CrtMemDumpStatistics |
<crtdbg.h> |
<errno.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость во введении.
Версии Библиотеки: Отладочные версии только для Функции библиотеки CRT.
Пример
См. раздел crt_dbg1.