以用户可读的形式转储指定堆状态的调试标头信息(仅限调试版本)。
语法
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 运行时库的调试版本。