Share via

2.2.3.1.43 LINEMEDIACONTROL_Constants

  • Article

The LINEMEDIACONTROL_Constants are bit-flag constants that describe a set of generic operations on media streams. The interpretations are determined by the media stream. The line device MUST have the media-control capability for any media-control operation to be effective.

Constant/value

Description

LINEMEDIACONTROL_NONE

0x00000001

No change is to be made to the media stream.

LINEMEDIACONTROL_START

0x00000002

Start the media stream.

LINEMEDIACONTROL_RESET

0x00000004

Reset the media stream. Equivalent to an end-of-input stream. All buffers are released.

LINEMEDIACONTROL_PAUSE

0x00000008

Temporarily pause the media stream.

The speed of the media stream must be returned to normal.

LINEMEDIACONTROL_RESUME

0x00000010

Resume a paused media stream.

LINEMEDIACONTROL_RATEUP

0x00000020

The speed of the media stream must be increased by some stream-defined quantity.

LINEMEDIACONTROL_RATEDOWN

0x00000040

The speed of the media stream must be decreased by some stream-defined quantity.

LINEMEDIACONTROL_RATENORMAL

0x00000080

The speed of the media stream must be returned to normal.

LINEMEDIACONTROL_VOLUMEUP

0x00000100

The amplitude of the media stream must be increased by some stream-defined quantity.

LINEMEDIACONTROL_VOLUMEDOWN

0x00000200

The amplitude of the media stream must be decreased by some stream-defined quantity.

LINEMEDIACONTROL_VOLUMENORMAL

0x00000400

The amplitude of the media stream must be returned to normal.

Media control is provided to improve performance of actions on media streams in response to telephony-related events.

Media-control actions can be associated with the detection of digits, the detection of tones, the transition into a call state, and the detection of a media type. Consult the device capabilities of a line to determine whether media control is available on the line.