This function deallocates a previously allocated data buffer. The memory reserved for the specified buffer is released.
Child buffers associated with a parent buffer must be deallocated, using MbufFree(), prior to deallocating the parent buffer.
Note that LUT buffers, once associated with another buffer, a digitizer, or a display, should either be disassociated before being freed, or freed after the assocaited buffer, digitizer, or display is freed.
To disassociate a display or digitizer LUTs, use MdigControl() with M_LUT_ID set to M_DEFAULT or MdispLut() with M_DEFAULT. In the case of buffers, use MbufControl() with M_ASSOCIATED_LUT set to M_DEFAULT.
Using MbufFree() on a buffer created with either MbufCreateColor() or MbufCreate2d() will free the internal structure required to map the buffer to existing memory, but MbufFree() will not free the allocated memory used by the created buffer.
Header | Include mil.h. |
Library | Use mil.lib. |
DLL | Requires mil.dll. |