LINE_NEWCALL訊息

TSPI LINE_NEWCALL 訊息會傳送至 LINEEVENT 回呼函式，每當 TAPI 尚未產生的新呼叫抵達 TAPI 已開啟的行時。 這必須是針對該呼叫傳送的第一則訊息。 TAPI 會將 htCall 不透明控制碼寫入服務提供者以 dwParam2傳遞的位置。 這會為服務提供者提供後續訊息中要使用的 htCall 值。

參數

htLine

行裝置的 TAPI 不透明物件控制碼。

htCall

未使用的。

dwMsg

值LINE_NEWCALL。

dwParam1

HDRVCALL類型的呼叫服務提供者不透明控制碼。 TAPI 會將此值當做 hdCall 參數傳遞，以在呼叫上叫用的後續程式中識別呼叫。

dwParam2

LPHTAPICALL 類型的指標，指向 HTAPICALL。 TAPI 會寫入 TAPI 不透明控制碼，以呼叫指定的位置。 服務提供者必須儲存此值，並將其傳遞為 htCall 參數，以識別其回報呼叫的後續事件中的呼叫。

此參數也可以取得 Null 值 (請參閱下列一節) 。

dwParam3

未使用的。

備註

服務提供者應該傳送 LINE_CALLSTATE 訊息做為此呼叫的下一個訊息。 LINE_NEWCALL事件不尋常，因為它也會將值傳回服務提供者。

此函式會報告源自服務提供者的任何新呼叫， (輸入、輸出、在電話起始，依此類) TAPI 和服務提供者尚未交換不透明控制碼。 這些控制碼會交換，讓 TAPI 和服務提供者後續可以提出要求和報告涉及呼叫的事件。 因為這些新呼叫不一定是輸入的，所以呼叫一開始可以是任何狀態，不一定是 供應 專案狀態。 如果服務提供者啟動併發現一或多個呼叫已在行上作用中，它會通知 TAPI，其中包含 LINE_NEWCALL 訊息，後面接著指出目前狀態 的LINE_CALLSTATE 訊息。 由使用者在手機上起始的新撥出電話會以 LINE_NEWCALL 訊息回報，而初始 LINE_CALLSTATE 訊息會指出通話處於 DIALTONE 狀態 (然後從該處繼續) 。

如果服務提供者在相同的中斷週期) 期間，在非常短 (的時間內將大量呼叫傳遞給 TAPI，TAPI 可能會變成待處理這些呼叫。 發生這種情況時，TAPI 會向服務提供者發出訊號，以在傳送更多呼叫之前稍候一段時間。 它會將Null值而非有效的HTAPICALL寫入LINE_NEWCALLdwParam2參數指向的位置，以發出訊號。 這表示嘗試處理新提供的呼叫控制碼未成功，很可能是因為暫時無法配置記憶體。 服務提供者可以藉由卸載呼叫，或在排程延遲 (期間重新傳送 LINE_NEWCALL 訊息來回應，此時服務提供者應該讓處理器讓 TAPI 處理其他擱置的動作) 。 在任何情況下，在控制碼交換成功之前，都無法將有關新呼叫的進一步訊息傳遞給 TAPI。 當 dwParam2 指向的位置取得非Null 值時，服務提供者知道此值是呼叫的有效 HTAPICALL 控制碼。

TAPI 層級沒有直接對應的訊息。 此訊息用於 TSPI 層級，以唯一且明確的方式導入 TAPI 的新來電，並擷取呼叫的 TAPI 不透明識別碼。

規格需求

另請參閱

LINE_CALLSTATE

LINEEVENT