ITLegacyCallMediaControl2::D etectTones 方法 (tapi3if.h)

DetectTones 方法启用和禁用在调用时检测带内音。 每次检测到指定的音调时,都会向应用程序发送一条消息。

此方法适用于 C/C++ 应用程序。 Visual Basic 和脚本应用程序应改用 DetectTonesByCollection 方法。

语法

HRESULT DetectTones(
  [in] TAPI_DETECTTONE *pToneList,
  [in] long            lNumTones
);

参数

[in] pToneList

指向 TAPI_DETECTTONE 数组的指针,该数组指定要检测的音调。 数组中的每个音调都有一个应用程序定义的标记字段,用于在报告 TE_TONEEVENT 类型的语气检测事件时标识列表中的单个音调。 有关更多信息,请参见下面的“备注”部分。

[in] lNumTones

pToneList 参数指定的数组中的条目数。 如果 pToneListNULL,则忽略此参数。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
方法成功。
E_POINTER
pToneList 参数不是有效的指针。
TAPI_E_INVALCALLSTATE
调用必须处于 连接 状态。

注解

此方法转换为 TAPI 2。xlineMonitorTones 调用。

若要取消正在进行的音调监视,请调用 DetectTones 方法并指定 NULLpToneList 参数。 若要更改要监视的音调列表,请调用此方法并指定新的音调列表。

要求

要求
目标平台 Windows
标头 tapi3if.h
Library Uuid.lib
DLL Tapi3.dll

另请参阅

ITLegacyCallMediaControl2

TAPI_DETECTTONE