LINE_CALLSTATE訊息
TAPI LINE_CALLSTATE 訊息會在指定的撥號狀態變更時傳送。 一般而言，在呼叫的存留期間會接收數個這類訊息。 應用程式會收到此訊息的新來電通知;新的呼叫處於 供應 專案狀態。 應用程式可以使用 lineGetCallStatus 來擷取有關呼叫目前狀態的詳細資訊。
參數
-
hDevice
-
呼叫的控制碼。
-
dwCallbackInstance
-
開啟呼叫行時提供的回呼實例。
-
dwParam1
-
新的撥號狀態。 此參數必須是下列其中一個 LINECALLSTATE_常數。
dwParam1 意義 - LINECALLSTATE_BUSY
dwParam2 包含忙碌模式的詳細資料。 此參數使用其中一個 LINEBUSYMODE_常數。 - LINECALLSTATE_CONNECTED
dwParam2 包含連線模式的詳細資料。 此參數使用其中一個 LINECONNECTEDMODE_常數。 - LINECALLSTATE_DIALTONE
dwParam2 包含撥號音調模式的詳細資料。 此參數使用其中一個 LINEDIALTONEMODE_常數。 - LINECALLSTATE_OFFERING
dwParam2 包含連線模式的詳細資料。 此參數使用其中一個 LINEOFFERINGMODE_常數。 - LINECALLSTATE_SPECIALINFO
dwParam2 包含特殊資訊模式的詳細資料。 此參數使用其中一個 LINESPECIALINFO_常數。 - LINECALLSTATE_DISCONNECTED
dwParam2 包含中斷連線模式的詳細資料。 此參數使用其中一個 LINEDISCONNECTMODE_常數。 -
dwParam2
-
撥號狀態相依資訊。 請參閱 dwParam1。
注意
在適當的 延遲 回應的情況下，請使用 LINEDISCONNECTMODE_TEMPFAILURE。 如果 封鎖清單 的回應適合，請使用LINEDISCONNECT_BLOCKED。 如需詳細資訊，請參閱 LINEDISCONNECTMODE_常數。
如果dwParam1是LINECALLSTATE_CONFERENCED，dwParam2會包含主旨 hCall 所屬會議父呼叫的hConfCall參數。 如果應用程式先前未將 dwParam2 中指定的通話視為父會議通話， (hConfCall，則應用程式必須執行此動作， 如果應用程式沒有會議父呼叫的控制碼 (，因為它先前在該控制碼上呼叫 lineDeallocateCall) dwParam2 設為 Null。
-
dwParam3
-
如果為零，這個參數表示呼叫的應用程式許可權沒有任何變更。
如果為非零，它會指定應用程式的呼叫許可權。 發生于下列情況： (1) 第一次為應用程式提供此呼叫控制碼時; (2) 即使應用程式已經是通話) 的擁有者，應用程式也是呼叫交接的目標 (。 此參數使用下列其中一個 LINECALLPRIVILEGE_常數。
傳回值
沒有傳回值。
備註
此訊息會傳送至具有呼叫控制碼的任何應用程式。 LINE_CALLSTATE訊息也會通知應用程式，監視其他應用程式所建立輸出通話是否存在和狀態，或由使用者手動 (例如，在連接的電話裝置上) 。 這類呼叫的撥號狀態會反映未 提供之呼叫的實際狀態。 藉由檢查撥號狀態，應用程式可以判斷呼叫是否為需要接聽的輸入呼叫。
具有未知撥號狀態 的LINE_CALLSTATE 訊息可以傳送至監視應用程式，因為 lineMakeCall、 lineForward、 lineUnpark、 lineSetupTransfer、 linePickup、 lineSetupConference或 linePrepareAddToConference 已由另一個應用程式要求。 同時，要求的應用程式會針對要求的作業傳送 LINE_REPLY () 成功 (，該行上的任何監視應用程式都會傳送 LINE_CALLSTATE (未知) 訊息。 LINE_CALLSTATE訊息，指出新產生呼叫的「實際」撥號狀態會使用服務提供者所提供的資訊 (傳送給要求和監視應用程式) 。
只有在lineCompleteTransfer導致通話解析成三向會議時，才會將LINE_CALLSTATE (未知) 訊息傳送至監視應用程式。
為了回溯相容性，較舊的應用程式不會預期 LINECALLSTATE_CONFERENCED訊息 dwParam2 中的任何特定值。 因此，無論接收訊息的應用程式 API 版本為何，TAPI 都會在dwParam2中傳遞父呼叫hConfCall。 在服務提供者起始的電話會議案例中，繼承應用程式不會察覺父呼叫已變成電話會議，除非它剛好檢查其他資訊 (例如 ，呼叫 lineGetConfRelatedCalls) 。
無法停用此訊息。
規格需求
| 需求 | 值 |
|---|---|
| TAPI 版本 |
需要 TAPI 2.0 或更新版本 |
| 標頭 |
|