itLegacyCallMediaControl2：：GenerateCustomTonesByCollection 方法 (tapi3if.h)

GenerateCustomTonesByCollection 方法生成指定的自定义音调。

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

语法

HRESULT GenerateCustomTonesByCollection(
  [in] ITCollection2 *pCustomToneCollection,
  [in] long          lDuration
);

[in] pCustomToneCollection

指向 ITCollection2 接口的指针，该接口包含表示音调组件的 ITCustomTone 接口指针集合。如果集合是多频音调，则同时播放各种音调。

[in] lDuration

应维持音调的持续时间（以毫秒为单位）。值为零使用默认持续时间。

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

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

此方法转换为对 TAPI 2 的调用。xlineGenerateTone 函数。

当音调生成完成后，将生成类型为 TE_GENERATEEVENT 的事件。