lineMonitorDigits 函式 (tapi.h)

發行項
03/02/2024

lineMonitorDigits 函式會啟用和停用呼叫上所接收之數位的未緩衝偵測。每次偵測到指定數位模式的位數時，都會傳送訊息給應用程式，指出偵測到哪些數位。

語法

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

參數

hCall

處理要偵測到位數的呼叫。 hCall 的呼叫狀態可以是閒置或中斷連線以外的任何狀態。

dwDigitModes

要監視的數位模式或模式。如果 dwDigitModes 為零，則會取消數字監視。此參數會使用一或多個 LINEDIGITMODE_常數。

傳回值

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALDIGITMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

備註

如果數位監視已正確起始，則此函式會被視為成功，而不是數位監視已終止時。數字監視會維持有效狀態，直到呼叫 lineMonitorDigits 且 dwDigitModes 設定為零、呼叫轉換為閑置，或應用程式解除分配呼叫句柄時，才會明確停用。雖然此函式可以在任何呼叫狀態中叫用，但只有在呼叫處於連線狀態時，才會偵測到數位。

每次偵測到數位時，都會將LINE_MONITORDIGITS訊息傳送至將偵測到的數位當作參數傳遞至應用程式。

應用程式可以使用 lineMonitorDigits 來啟用或停用未緩衝的數位偵測。它可以使用 lineGatherDigits 進行緩衝的數位偵測。緩衝數位收集完成後，會將LINE_GATHERDIGITS 訊息傳送至應用程式。可以同時在相同的呼叫上啟用緩衝和未緩衝的數位偵測。

會議通話上的數字監視僅適用於 hConfCall，不適用於個別參與通話。