lineSetNumRings 函式 (tapi.h)

發行項
03/02/2024

lineSetNumRings 函式會設定接聽來電之前必須發生的通道數目。此函式可用來實作 toll-saver-style 函式。它允許多個獨立應用程式註冊通道數目。函式 lineGetNumRings 會傳回所要求的最小信道數目。應用程式可以使用它來接聽來電，以判斷接聽通話之前應該等候的通道數目。

語法

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

參數

hLine

開啟行裝置的句柄。

dwAddressID

線路裝置上的位址。位址標識符會永久與地址相關聯;標識碼在操作系統升級期間會維持不變。

dwNumRings

應接聽通話之前的通道數目，以接受來自所有應用程式的付費節省電話要求。

傳回值

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESSID、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

備註

結合使用lineGetNumRings和lineSetNumRings函式時，提供一種機制，以支援跨多個獨立應用程式實作付費儲存器功能。如果沒有任何應用程式呼叫 lineSetNumRings，lineGetNumRings 會傳回0xFFFFFFFF。

處於供應項目狀態且收到LINE_LINEDEVSTATE響訊息的通話擁有者，在接聽通話之前，接聽電話之前，接聽電話之前，接收LINE_LINEDEVSTATE響訊息的應用程式應該會等到 lineGetNumRings 傳回的號碼，以接受所有應用程式的付費保護設定。個別的LINE_LINEDEVSTATE 響鈴訊息會針對每個通道週期傳送至應用程式，因此應用程式應該計算這些訊息。如果此通話在接聽之前中斷連線，且稍後會接聽另一個通話，則LINE_CALLSTATE 訊息應該允許應用程式判斷響鈴與第二次呼叫有關。

如果 TAPI 藉由接聽未知媒體類型的來電並篩選媒體串流來執行通話分類，TAPI 也會接受此號碼。

注意這項作業完全是參考性的，不會影響線路裝置上任何呼叫的狀態。