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 的事件。