LINEMEDIACONTROLTONE 结构 (tapi.h)

LINEMEDIACONTROLTONE 结构描述检测到音调时要执行的媒体操作。 它用作数组中的条目。 lineSetMediaControlTSPI_lineSetMediaControl 函数使用此结构。

语法

typedef struct linemediacontroltone_tag {
  DWORD dwAppSpecific;
  DWORD dwDuration;
  DWORD dwFrequency1;
  DWORD dwFrequency2;
  DWORD dwFrequency3;
  DWORD dwMediaControl;
} LINEMEDIACONTROLTONE, *LPLINEMEDIACONTROLTONE;

成员

dwAppSpecific

由应用程序用于标记音调。 检测到此音调时, dwAppSpecific 成员的值将传递回应用程序。

dwDuration

在进行检测之前应显示音调的持续时间(以毫秒为单位)。

dwFrequency1

音调的第一个频率,以赫特为单位。

dwFrequency2

第二个频率的音调,以赫为单位。

dwFrequency3

音调的第三个频率,以赫为单位。 如果音调中需要的频率少于三个,则应将值 0 用于未使用的频率。 所有三个频率都设置为零的音调被解释为静音,可用于静音检测。

dwMediaControl

媒体控制操作。 此成员使用 LINEMEDIACONTROL_常量之一。

注解

此结构可能无法扩展。

LINEMEDIACONTROLTONE 结构定义元组<音调媒体控制操作>。 这些元组的数组传递给 lineSetMediaControl 函数,以设置由给定调用的媒体类型更改触发的媒体控制操作。 当检测到对列出的媒体类型的更改时,将调用对媒体流的相应操作。

所有频率都设置为零的音调对应于静音。 因此,应用程序可以监视呼叫的信息流以保持静音。

要求

要求
Header tapi.h

另请参阅

TSPI_lineSetMediaControl

lineSetMediaControl