itLegacyCallMediaControl2：:D etectTonesByCollection 方法 (tapi3if.h)

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

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

语法

HRESULT DetectTonesByCollection(
  [in] ITCollection2 *pDetectToneCollection
);

[in] pDetectToneCollection

指向 ITCollection2 接口的指针，该接口包含表示要监视的音调的 ITDetectTone 接口指针的集合。列表中的每个音调都有一个应用程序定义的标记字段，用于在 TE_TONEEVENT 事件报告音调检测时标识各个音调。有关更多信息，请参见下面的“备注”部分。

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

返回代码	说明
S_OK	方法成功。
E_POINTER	pDetectToneCollection 参数不是有效的指针。
E_OUTOFMEMORY	内存不足，无法分配音调缓冲区。
TAPI_E_INVALCALLSTATE	调用必须处于连接状态。

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

若要取消正在进行的音调监视，请调用 DetectTonesByCollection 方法并指定空集合。若要更改要监视的音调列表，请调用此方法并指定新的音调集合。