Closing context handles

Depending on mm-renderer's configuration, client applications may be allowed to obtain additional handles to existing contexts. This configuration setting determines mm-renderer's behavior 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, mm-renderer's 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. See the descriptions of the -c and -o command-line options for further clarification.

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

In all circumstances, it's important to properly close unneeded context handles to ensure memory leaks don't occur.