mmr_context_destroy()

Synopsis:

#include <mm/renderer.h>

int mmr_context_destroy( mmr_context_t *ctxt )

Arguments:

ctxt: A context handle.

Library:

mmrndclient

Description:

Destroy the context the handle refers to and close the handle. Implicitly stop any playback and detach any input or outputs. If any other handles to this context still exist, attempts to use them will fail. At this point, you should close those handles by calling mmr_context_close() on each one.

In addition to calling mmr_context_destroy(), you can destroy a context in these ways:

calling mmr_context_close() using the primary handle (if your configuration disallows orphan handles)
calling mmr_disconnect() (if you have the primary handle)
terminating the process (if you have the primary handle)

Returns:

Zero on success, -1 on failure (check errno). The handle becomes invalid either way.

Classification:

QNX Neutrino

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes