|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
Dumps the debug header information for a specified heap state in a user-readable form (debug version only).
Pointer to the heap state to dump.
The _CrtMemDumpStatistics function dumps the debug header information for a specified state of the heap in a user-readable form. The dump statistics can be used by the application to track allocations and detect memory problems. The memory state can contain a specific heap state or the difference between two states. Whenis not defined, calls to _CrtMemDumpStatistics are removed during preprocessing.
The state parameter must be a pointer to a _CrtMemState structure that has been filled in by or returned by before _CrtMemDumpStatistics is called. If state is NULL, the invalid parameter handler is invoked, as described in . If execution is allowed to continue, errno is set to EINVAL and no action is taken. For more information, see .
For more information about heap state functions and the _CrtMemState structure, see. For information about how memory blocks are allocated, initialized, and managed in the debug version of the base heap, see .
|Routine||Required header||Optional headers||Compatibility|
Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003
For more compatibility information, seein the Introduction.
Libraries: Debug versions ofonly.