INtime SDK Help
_CrtMemDumpStatistics
INtime SDK v7 > About INtime > Other system libraries > Heaps and memory pools > Using the Debug Heap > Heap State Reporting Functions > _CrtMemDumpStatistics

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

void _CrtMemDumpStatistics ( 
    const _CrtMemState * state
);

Parameters

state
Pointer to the heap state to dump.

Remarks

_CrtMemDumpStatistics dumps the debug header information for a specified state of the heap in a user-readable form. The application can use dump statistics to track allocations and detect memory problems. The memory state can contain a specific heap state or the difference between two states. When _DEBUG is not defined, preprocessing removes calls to _CrtMemDumpStatistics.

The state parameter must be a pointer to a _CrtMemState structure filled 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.

Return Values

None.

Requirements

Versions Defined in Include Link to
INtime 3.13 intime/rt/include/crtdbg.h crtdbg.h clib.lib
   
See Also