TSPI_lineAddToConference函式 (tspi.h)

發行項
03/13/2024

TSPI_lineAddToConference函式會將 hdConsultCall 指定的呼叫新增至 hdConfCall 所指定的會議通話。

語法

LONG TSPIAPI TSPI_lineAddToConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdConfCall,
  HDRVCALL      hdConsultCall
);

參數

dwRequestID

異步要求的標識碼。

hdConfCall

會議通話的句柄。 hdConfCall 的呼叫狀態可以是 onHoldPendingConference 或 onHold。

hdConsultCall

要新增至會議通話之通話的句柄。此通話不能是另一個會議的父代或任何會議的參與者。根據 LINEADDRESSCAPS 中所指出的裝置功能， hdConsultCall 參數不一定是使用 TSPI_lineSetupConference 或 TSPI_linePrepareAddToConference 來建立。 hdConsultCall 的呼叫狀態可以連線、onHold、繼續或回撥。

傳回值

如果發生錯誤，則傳回 dwRequestID 或錯誤號碼。如果函式成功，則對應ASYNC_COMPLETION的 lResult 實際參數為零;如果發生錯誤，則為錯誤號碼。可能的傳回值如下所示：

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

備註

如果 hdConsultCall 是另一個會議的父代或已經是會議中的參與者，或因為其他原因而無法新增 hdConsultCall ，例如必須使用 TSPI_lineSetupConference 或TSPI_linePrepareAddToConference來建立服務提供者，則服務提供者會傳回 LINEERR_INVALCALLHANDLE。

注意在將通話新增至會議之後，新增合作物件的通話句柄仍有效;一般而言，其狀態會變更為會議，而會議通話的狀態會變成 已連線。稍後可以使用個別參與通話的句柄，以使用 TSPI_lineRemoveFromConference 從會議通話中移除該派對。

參與會議之通話的通話狀態並不獨立。例如，卸除通話時，所有參與通話都可能會自動變成閑置狀態。 TAPI 可以諮詢線路的裝置功能，以判斷可用的會議移除形式。 TAPI 或其用戶端應用程式應該追蹤 LINE_CALLSTATE 訊息，以判斷涉及的呼叫發生什麼事。

會議會透過 TSPI_lineSetupConference 或 TSPI_lineCompleteTransfer來建立。一般而言，新增至會議的通話是使用 TSPI_lineSetupConference 或 TSPI_linePrepareAddToConference來建立。有些交換器可能會允許新增任意通話到會議，而且這類通話可能已使用 TSPI_lineMakeCall 來設定，而且 (硬式) 保留。所有屬於會議一部分的通話都必須位於相同的開啟行上。

會議通話上任何監視 (媒體、音調、數位) 僅適用於 hdConfCall 參數，不適用於個別參與通話。

此函式沒有根據 TAPI 層級對應函式的許可權限制。服務提供者不需要明確追蹤「父」會議通話與其參與者之間的關聯性，因為TAPI函式沒有TSPI對應。許多服務提供者可能會發現必須在內部追蹤這些關聯性，以實作其他會議通話管理功能。