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

MmStatus()

Return the status of a multimedia graph or filter

Synopsis:

int32_t MmStatus(const void *element);

Arguments:

element

A pointer to a graph or filter.

Library:

mmedia

Description:

This function returns the status of the media element. If the status isn't an error, it's a positive number:

• MM_STATUS_PLAYING
• MM_STATUS_PAUSING
• MM_STATUS_PAUSED
• MM_STATUS_EOF
• MM_STATUS_STOPPING
• MM_STATUS_STOPPED
• MM_STATUS_TIMEDOUT

Returns:

>0

Success.

<0

An error occurred.

Examples:

  // Assuming the given graph is created, and hooked up,
  // and we want to know the current status (running, not
  // running, paused, playing, etc.)

  int32_t status=MmStatus(graph);

  //
  // Assuming the given filter is created, and hooked up,
  // and we want to know the current status (running, not
  // running, paused, playing, etc.)

  int32_t status=MmStatus(filter);

Classification:

Neutrino

See also:

MmGetResourceValue()