| Customize Help

Removing a buffer from the display


To remove an image buffer from the display, you can use MdispSelect() or MdispSelectWindow() with M_NULL, depending on which function was used to select the buffer to the display. For MIL windowed displays, this closes the associated window; whereas for user-defined windowed displays, this leaves the associated window open but leaves it blank. For exclusive displays, this causes the display to disappear, allowing the desktop to reappear on the screen.

To display a different image buffer, you are not required to remove the current buffer from the display; selecting another buffer for display automatically updates the display with the new buffer.

You can only remove the entire image buffer from the display. Therefore, when displaying a parent buffer, you cannot remove one of its child buffers from the display.

Once you have finished using a display, you must free it using MdispFree().

Freeing the display, or freeing the buffer currently selected to the display, produces the same visual effect as when using MdispSelect() or MdispSelectWindow() with M_NULL.