LINEMEDIACONTROLMEDIA structure (tapi.h)

The LINEMEDIACONTROLMEDIA structure describes a media action to be executed when detecting a media type change. It is used as an entry in an array. The lineSetMediaControl and TSPI_lineSetMediaControl functions use this structure.

Syntax

typedef struct linemediacontrolmedia_tag {
  DWORD dwMediaModes;
  DWORD dwDuration;
  DWORD dwMediaControl;
} LINEMEDIACONTROLMEDIA, *LPLINEMEDIACONTROLMEDIA;

Members

dwMediaModes

One or more media types. This member uses one of the LINEMEDIAMODE_ Constants.

dwDuration

Duration of time during which the media type should be present before the application should be notified or media control action should be taken, in milliseconds.

dwMediaControl

Media control action. This member uses one of the LINEMEDIACONTROL_ Constants.

Remarks

This structure may not be extended.

The LINEMEDIACONTROLMEDIA structure defines a triple <media type(s), duration, media-control action>. An array of these triples is passed to the lineSetMediaControl function to set the media control actions triggered by media type changes for a given call. When a change to a listed media type is detected, then the corresponding action on the media stream is invoked.

Requirements

Requirement Value
Header tapi.h

See also

TSPI_lineSetMediaControl

lineSetMediaControl