Configuration - Merge Healthcare

Merge DICOM Toolkit Reference Manual
24
See Also
MC_Set_Value_From_Function MC_Get_Value_To_Function
MC_Cleanup_Memory
Releases memory allocated but not in use by the Merge DICOM Toolkit library.
Synopsis
#include “mergecom.h”
MC_STATUS MC_Cleanup_Memory (int Timeout)
Timeout Maximum time, in seconds, that this function should attempt to
cleanup memory.
Remarks
MC_Cleanup_Memory allows an application to reduce the amount of memory
consumed by the toolkit. The Merge toolkit uses an internal memory
management system to increase performance. This increase in performance is
at the expense of keeping allocated memory block available by not freeing them
to the operating system. This call allows memory blocks not in use to be returned
to the operating system.
This call can take a significant amount of time if a large amount of memory is to
be freed. The timeout can be used to make incremental improvements in the
memory usage. Calls to this function pick up where the previous call left off. If
the timeout expires before the function is complete, MC_TIMEOUT is returned
Return Value
One of the enumerated MC_STATUS codes defined in “mcstatus.h”:
Value Meaning
MC_NORMAL_COMPLETION The function completed
MC_LIBRARY_NOT_INITIALIZED
normally.
Call made prior to library initialization
MC_TIMEOUT The timeout expired before the entire
cleanup was finished.
MC_VALUE_OUT_OF_RANGE The timeout was less then 0.
See Also