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，則會忽略此參數。

這個方法可以傳回其中一個值。

這個方法會轉譯為 TAPI 2。xlineMonitorTones 呼叫。

若要取消進行中的音調監視，請呼叫 DetectTones 方法，並指定 NULLpToneList 參數。若要將音調清單變更為監視，請呼叫此方法並指定新的音調清單。