lineGetNumRings 函式 （tapi.h）

lineGetNumRings 函式會決定在接聽通話之前，指定地址上來電的響鈴數目。

語法

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

參數

hLine

開啟行裝置的句柄。

dwAddressID

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

lpdwNumRings

所有目前 lineSetNumRings 要求的通道數目下限。

傳回值

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

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

言論

lineGetNumRings 和 lineSetNumRings 函式搭配使用時，提供一個機制來支援跨多個獨立應用程式實作收費保護器功能。

在提供 狀態的 接收呼叫句柄的應用程式，以及 LINE_LINEDEVSTATE響鈴 訊息，應等候數個通道，與 lineGetNumRings 傳回的號碼相等，再接聽通話，以便接受所有應用程式的收費保護程序設定。 lineGetNumRings 函式會傳回 lineSetNumRings所指定之所有應用程式通道數目的最小值。 由於此號碼可能會動態變化，因此應用程式應該在每次有接聽呼叫的選項時，叫用 lineGetNumRings。 如果沒有應用程式呼叫 lineSetNumRings，則傳回的通道數目會0xFFFFFFFF。 每個通道週期都會將個別的LINE_LINEDEVSTATE 响铃 訊息傳送至應用程式。

如果 TAPI 會執行通話分類，以接聽未知媒體模式的所有呼叫並篩選媒體串流，TAPI 也會接受此號碼。

注意 此作業純粹是參考性的，本身不會影響線路裝置上任何呼叫的狀態。

 

要求

要求	價值
目標平臺	窗戶
標頭	tapi.h
連結庫	Tapi32.lib
DLL	Tapi32.dll

另請參閱

基本電話語音服務參考

LINE_LINEDEVSTATE

TAPI 2.2 參考概觀

lineSetNumRings