TSPI_lineMonitorDigits函式 (tspi.h)

發行項
03/03/2024

TSPI_lineMonitorDigits函式會啟用和停用呼叫上所接收數位的未緩衝偵測。每次偵測到指定數位模式 () 時，TAPI 就會傳送 LINE_MONITORDIGITS 訊息給應用程式，指出偵測到哪一個數位。

語法

LONG TSPIAPI TSPI_lineMonitorDigits(
  HDRVCALL hdCall,
  DWORD    dwDigitModes
);

參數

hdCall

要偵測到數位的呼叫句柄。 hdCall 的呼叫狀態可以是閑置或中斷連線以外的任何狀態。

dwDigitModes

要監視的數位模式 () 。值為 0 的 dwDigitModes 參數會取消數位監視。 dwDigitModes 參數可以有其中一個LINEDIGITMODE_常數。

傳回值

如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。可能的傳回值如下所示：

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

備註

當正確起始數位監視時，此函式會傳回零 (成功) ，而不是在終止數位監視時傳回。數字監視會維持有效狀態，直到呼叫 dwDigitModes 設定為零或呼叫轉換為閑置為止，直到呼叫明確停用TSPI_lineMonitorDigits為止。 (取消數字監視時，函式必須傳回零，也就是 dwDigitModes 參數為零) 。服務提供者必須在呼叫閑置時終止數字監視。 TAPI 不會不定期呼叫 TSPI_lineMonitorDigits 來終止監視。

雖然此函式可以在任何呼叫狀態中叫用，但只有在呼叫處於連線狀態時，才會偵測到數位。

每次偵測到數位時，服務提供者都會將 LINE_MONITORDIGITS 訊息傳送至TAPI，並將偵測到的數字當做參數傳遞。如果在 dwDigitModes 中同時設定LINEDIGITMODE_DTMF和LINEDIGITMODE_DTMFEND，則會針對每個數位傳送兩個LINE_MONITORDIGITS訊息。

TAPI 可以使用 TSPI_lineMonitorDigits 來啟用或停用未緩衝的數位偵測。它可以使用 TSPI_lineGatherDigits 進行緩衝的數位偵測。緩衝的數位收集完成後，就會傳送 LINE_GATHERDIGITS 訊息。緩衝和未緩衝的數位偵測都可以同時在同一個呼叫上啟用。