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