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 参数指定的数组中的条目数。 如果 pToneList 为 NULL,则忽略此参数。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
pToneList 参数不是有效的指针。 |
|
调用必须处于 连接 状态。 |
注解
此方法转换为 TAPI 2。xlineMonitorTones 调用。
若要取消正在进行的音调监视,请调用 DetectTones 方法并指定 NULLpToneList 参数。 若要更改要监视的音调列表,请调用此方法并指定新的音调列表。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tapi3if.h |
Library | Uuid.lib |
DLL | Tapi3.dll |