Export (0) Print
Expand All
div
Expand Minimize

_CrtMemDumpStatistics

Dumps the debug header information for a specified heap state in a user-readable form (debug version only).

void _CrtMemDumpStatistics( 
   const _CrtMemState *state 
);

Parameter

state
Pointer to the heap state to dump.

Remarks

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 may contain a specific heap state or the difference between two states. When _DEBUG is 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 _CrtMemCheckpoint or returned by _CrtMemDifference before _CrtMemDumpStatistics is called.

For more information about heap state functions and the _CrtMemState structure, see Heap State Reporting Functions. For information about how memory blocks are allocated, initialized, and managed in the debug version of the base heap, see Memory Management and the Debug Heap.

Requirements

Routine Required header Compatibility
_CrtMemDumpStatistics <crtdbg.h> Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.

Libraries

Debug versions of C run-time libraries only.

Example

For a sample of how to use _CrtMemDumpStatistics, see crt_dbg1.

See Also

Debug Functions | Run-Time Routines and .NET Framework Equivalents

Show:
© 2014 Microsoft