mmr_context_destroy()

Destroy a context.

Synopsis:

#include <mm/renderer/renderer.h>

int mmr_context_destroy(mmr_context_t *ctxt)

Since:

BlackBerry 10.0.0

Arguments:

ctxt: A context handle.

Library:

libmmrndclient (For the qcc command, use the -l mrndclient option to link against this library)

Description:

Destroy the context the handle refers to and close the handle. Implicitly stop any playback and detach any inputs or outputs.

In addition to explicitly calling mmr_context_destroy() with a primary or secondary handle, a context is also destroyed when the primary handle is closed for any reason, including:

calling mmr_context_close() using the primary handle
calling mmr_disconnect() with the connection that the primary handle is associated with
terminating the process that has the primary handle

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, disconnecting by calling mmr_disconnect(), or terminating the process.

Returns:

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