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 方法並指定空的集合。若要變更要監視的音調清單，請呼叫此方法並指定新的音調集合。