Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

MmDestroyGraph()

Destroy a multimedia graph

Synopsis:

int32_t MmDestroyGraph(MmGraph_t *graph);

Arguments:

graph
A pointer to the multimedia graph to destroy.

Library:

mmedia

Description:

This function destroys a multimedia graph and frees its resources. Calling MmDestroyGraph() causes the graph to perform the following steps:

  1. Signal all the filters in the graph to stop.
  2. Once all filters are stopped, detach and release each filter's channels.
  3. Free the filters.
  4. Destroy the graph.

Returns:

0
Success.
-1
An error occurred.

Examples:

  // Destroy a previously created graph:

  MmDestroyGraph(graph);

Classification:

Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

MmInitialize(), MmCreateGraph()