_CrtMemDumpStatistics

以用户可读的形式转储指定堆状态的调试标头信息（仅限调试版本）。

语法

void _CrtMemDumpStatistics(
   const _CrtMemState *state
);

参数

state
指向要转储的堆状态的指针。

注解

_CrtMemDumpStatistics 函数以用户可读的形式转储指定堆状态的调试标头信息。 应用程序可以使用转储统计信息来跟踪分配并检测内存问题。 内存状态可以包含特定的堆状态或两个状态之间的差异。 未定义 _DEBUG 时，会在预处理过程中删除对 _CrtMemDumpStatistics 的调用。

state 参数必须是指向 _CrtMemState 结构的指针，该结构由 _CrtMemCheckpoint 填充，或者在调用 _CrtMemDumpStatistics 之前由 _CrtMemDifference 返回。 如果 state 为 NULL，则会调用无效的参数处理程序，如参数验证中所述。 如果允许执行继续，errno 会设置为 EINVAL，并且不执行任何操作。 有关详细信息，请参阅errno, _doserrno, _sys_errlist和_sys_nerr.

有关堆状态函数和 _CrtMemState 结构的详细信息，请参阅堆状态报告函数。 有关如何在基堆的调试版本中分配、初始化和管理内存块的详细信息，请参阅 CRT 调试堆详细信息。

要求

例程	必需的标头	可选标头
_CrtMemDumpStatistics	<crtdbg.h>	<errno.h>

有关兼容性的详细信息，请参阅 兼容性。

库：仅限 C 运行时库的调试版本。

另请参阅

调试例程