共用方式為


lineSetupConference 函式 (tapi.h)

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

語法

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

參數

hCall

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

hLine

行的控制碼。 如果 hCallNull,此控制碼可用來識別產生會議通話的線路裝置。 如果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) 的控制碼,會議通話和諮詢通話通常會進入閒置狀態。

規格需求

   
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

會議概觀

LINECALLPARAMS

LINEDEVCAPS

LINEDEVSTATUS

LINE_CALLSTATE

增補行服務函式

lineCompleteTransfer

lineDial

lineDrop

lineGetLineDevStatus

lineSwapHold

lineUnhold