lineMonitorTones 函式 (tapi.h)

lineMonitorTones 函式會啟用和停用呼叫上的頻內音偵測。 每次偵測到指定的音調時，都會將訊息傳送至應用程式。

語法

LONG lineMonitorTones(
  HCALL                   hCall,
  LPLINEMONITORTONE const lpToneList,
  DWORD                   dwNumEntries
);

參數

hCall

處理要監視其語音通道音調的通話。 hCall 的呼叫狀態可以是閑置以外的任何狀態。

lpToneList

要監視的音調清單。 此參數的類型為 LINEMONITORTONE。 此清單中的每個音調都有應用程式定義的標記欄位，用來識別清單中的個別音調，以報告音調偵測。 進行中的音調監視會取消或變更，方法是針對 lpToneList 或另一個音調清單呼叫此作業 NULL。

dwNumEntries

lpToneList 中的項目數。 如果 lpToneList 為 NULL，則會忽略此參數。

傳回值

如果要求成功或發生錯誤，則傳回零。 可能的傳回值為：

LINEERR_INVALCALLHANDLE、LINEERR_INVALCALLSTATE、LINEERR_INVALPOINTER、LINEERR_INVALTONE、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。

備註

如果已正確起始音調監視，而不是當音調監視終止時，此函式就會成功。 音調監視會維持有效狀態，直到使用另一個音調清單來呼叫 lineMonitorTones ， (或 NULL) 、直到呼叫轉換到 閒置，或當應用程式解除分配呼叫句柄時為止。

雖然此函式可以在任何呼叫狀態中叫用，但通常只能在呼叫處於 連線 狀態時偵測到音調。 音調偵測通常需要計算資源。 根據服務提供者和其他競爭這類資源的活動，可以偵測到的音調數目可能會隨著時間而有所不同。 此外，監視單一三次頻率音調與三個單一頻率音調，可以耗用對等的資源量。 如果資源已過度認可，則會傳回LINEERR_RESOURCEUNAVAIL錯誤。

lineMonitorTones 函式也可用來偵測無聲。 無聲會指定為頻率為零的音調。

會議通話上的音調監視僅適用於 hConfCall，不適用於個別參與通話

如果傳回LINEERR_INVALPOINTER錯誤值，則指定的 lpToneList 參數無效，或 dwNumEntries 參數所指定的值太大。

規格需求

需求	值
目標平台	Windows
標頭	tapi.h
程式庫	Tapi32.lib
Dll	Tapi32.dll

另請參閱

LINEMONITORTONE

增補線路服務函式

TAPI 2.2 參考概觀