Closing context handles

Depending on the mm-renderer configuration, client applications may be allowed to obtain additional handles to existing contexts. This configuration setting determines the behavior of mm-renderer when closing context handles.

Handles obtained by opening existing contexts are called secondary context handles, whereas the handle obtained by creating a context is called the primary context handle.

In addition, the configuration may allow a context to exist after its primary handle has been closed. This is called an orphan context. When orphan contexts are allowed, secondary handles are also allowed; however, secondary handles may be allowed when orphan contexts aren't. For further clarification, see the descriptions of the -c and -o options for the mm-renderer command-line.

The behavior of mm-renderer in closing context handles depends on your orphan context policy:

Note: In all circumstances, it's important to properly close unneeded context handles to prevent memory leaks.