lineSetupConference 函式 (tapi.h)

發行項
08/26/2023

lineSetupConference函式會設定協力廠商新增的會議通話。

語法

LONG lineSetupConference(
  HCALL                  hCall,
  HLINE                  hLine,
  LPHCALL                lphConfCall,
  LPHCALL                lphConsultCall,
  DWORD                  dwNumParties,
  LPLINECALLPARAMS const lpCallParams
);

參數

hCall

處理識別會議第一方的初始通話。在某些環境中 (如裝置功能) 所述，通話必須存在才能開始電話，而且應用程式必須是此通話的擁有者。在其他電話語音環境中，一開始沒有通話存在， hCall 必須保留 Null，而且必須指定 hLine ，才能識別要起始通話的行。必須連線hCall的撥號狀態。

hLine

行的控制碼。如果 hCall 為 Null，此控制碼可用來識別產生會議通話的線路裝置。如果hCall為非Null，則會忽略hLine參數。

lphConfCall

HCALL 控制碼的指標。此位置接著會載入識別新建立之會議通話的控制碼。應用程式是此呼叫的初始唯一擁有者。 hConfCall的撥號狀態不適用。

lphConsultCall

HCALL 控制碼的指標。為新增新的合作物件設定通話時，會自動設定新的暫時通話 (諮詢通話) 。一開始，應用程式是此呼叫的唯一擁有者。

dwNumParties

會議中預期的派對數目。此號碼會傳遞至服務提供者。服務提供者可以隨意執行此數位：請忽略它，將其作為提示，以在交換器內配置正確的大小會議橋接器，依此類錯。

lpCallParams

LINECALLPARAMS結構的指標，其中包含建立諮詢呼叫時要使用的呼叫參數。如果不需要任何特殊的呼叫安裝參數，這個參數可以設定為 Null 。

傳回值

如果函式是以非同步方式完成，則傳回正要求識別碼，如果發生錯誤，則傳回負錯誤號碼。如果函式成功，則對應LINE_REPLY訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。可能的傳回值為：

LINEERR_BEARERMODEUNAVAIL、LINEERR_UNINITIALIZED、LINEERR_CALLUNAVAIL、LINEERR_INVALMEDIAMODE、LINEERR_CONFERENCEFULL、LINEERR_INVALPOINTER、LINEERR_INUSE、LINEERR_INVALRATE、LINEERR_INVALADDRESSMODE、LINEERR_NOMEM、LINEERR_INVALBEARERMODE、LINEERR_NOTOWNER、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLPARAMS、LINEERR_RATEUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL LINEERR_INVALLINESTATE、LINEERR_STRUCTURETOOSMALL、LINEERR_USERUSERINFOTOOBIG。

備註

如果傳回LINEERR_INVALLINESTATE，此行目前不是可執行此作業的狀態。目前有效的作業清單可以在LINEDEVSTATUS結構中 LINEFEATURE類型 (的dwLineFeatures成員) 中找到。 (呼叫lineGetLineDevStatus會更新LINEDEVSTATUS.) 如果傳回LINEERR_INVALMEDIAMODE，請檢查LINEDEVCAPS結構中dwMediaModes成員的行上是否支援媒體類型。

lineSetupConference 函式提供兩種方式來建立新的通話，視一般兩方通話是否需要預先存在而定。從現有的兩方通話設定通話時， hCall 參數是一個有效的通話控制碼，一開始會由 lineSetupConference 要求新增至會議通話; 忽略 hLine 。在會議通話設定不是以現有通話開始的交換器上， hCall 必須是 Null ，且 必須指定 hLine ，才能識別要起始通話的線路裝置。不論是哪一種情況，都會配置諮詢通話，以連線到要新增至通話的合作物件。然後，應用程式可以使用 lineDial 來撥號另一方的位址。

會議通話通常會轉換成 onHoldPendingConference 狀態、諮詢通話進入撥號狀態，以及如果 會議狀態有 一) ，則初始通話 (。

電話會議也可以由解析成三向會議的 lineCompleteTransfer 來設定。應用程式可以使用 lineSwapHold在諮詢通話與會議通話之間切換。

您可以叫用 lineDrop 來取消諮詢通話。卸載諮詢通話時，現有的會議通話通常會轉換回連線狀態。應用程式應該觀察LINE_CALLSTATE訊息，以確切判斷呼叫會發生什麼事。例如，如果會議通話還原回一般兩方通話，會議通話就會變成閒置狀態，而原始參與者通話可以還原為 已連線。

如果應用程式在lineUnhold函式的通話中指定原始通話 (hCall) 的控制碼，會議通話和諮詢通話通常會進入閒置狀態。