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

Dumps information about objects in the heap from the start of program execution or from a specified heap state (debug version only).

void _CrtMemDumpAllObjectsSince (
    const _CrtMemState * _State
);

Parameters

_State
Pointer to the heap state to begin dumping from or NULL.

Remarks

_CrtMemDumpAllObjectsSince dumps the debug header information of objects allocated in the heap in a user-readable form. The application can use the dump information to track allocations and detect memory problems. When _DEBUG is not defined, preprocessing removes calls to _CrtMemDumpAllObjectsSince.

_CrtMemDumpAllObjectsSince uses the value of the _State parameter to determine where to initiate the dump operation. To begin dumping from a specified heap state, the _State parameter must be a pointer to a _CrtMemState structure filled by _CrtMemCheckpoint before _CrtMemDumpAllObjectsSince was called. When _State is NULL, the function begins the dump from the start of program execution.

If the application installed a dump hook function by calling _CrtSetDumpClient then, each time _CrtMemDumpAllObjectsSince dumps information about a _CLIENT_BLOCK type of block, it calls the application-supplied dump function as well. By default, memory dump operations do not include:

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