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

MmDestroyFilter()

Destroy a multimedia filter

Synopsis:

int32_t MmDestroyFilter(MmFilter_t *filter);

Arguments:

filter

The filter you want to destroy.

Library:

mmedia

Description:

This function destroys the filter, and removes it from its graph. Before you call this function, you must make sure that the filter:

• is valid
• is stopped -- use MmStop()
• has no attached channels -- use MmDetachChannel().

Returns:

0

Success.

-1

An error occurred.

Examples:

  // filter was previously created.

  MmDestroyFilter(filter);

Classification:

Neutrino

See also:

MmFindChannelsFilter(), MmFindFilter()