mmr_context

Synopsis:

#include <mm/renderer.h>

mmr_context_t* mmr_context_open( mmr_connection_t *connection,
                                 const char *name )

Arguments:

connection: An mm-renderer connection handle.

name: The context name.

Library:

mmrndclient

Description:

Open a handle to an existing context. The handle returned by this function is called a secondary handle.

Whether this operation is allowed depends on the options that you define for the mm-renderer process (for details, see "mm-renderer command line"). If you set these options to disallow the opening of secondary handles, this function fails and sets the global variable errno to EPERM. If these options allow the opening of secondary handles, you can open as many as you like, and the function will return a new handle with each successful call.

To avoid memory leaks, every handle opened with mmr_context_open() needs to be closed, either explicitly through an API call or implicitly by terminating the process.

Returns:

A handle on success, or a null pointer on failure (check errno).

Classification:

QNX Neutrino

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes