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

MmReleaseChannel()

Release a multimedia channel

Synopsis:

int32_t MmReleaseChannel(MmChannel_t *channel);

Arguments:

channel
A pointer to the channel you want to release.

Library:

mmedia

Description:

This function releases the channel from its filter.

If channel is attached to another filter, you should call MmDetachChannel() instead of this function. You should call MmReleaseChannel() only if you can't attach a given channel after acquiring it.

Returns:

0
Success.
-1
An error occurred.

Examples:

  // We previously acquired this channel, and now we're done
  // with it, so we want to release the channel.

  MmReleaseChannel(channel);

Classification:

Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

MmAcquireInputChannel(), MmAcquireOutputChannel(), MmChannel_t, MmDetachChannel()