fungsi lineSetupConference (tapi.h)

Artikel
08/26/2023

Fungsi lineSetupConference menyiapkan panggilan konferensi untuk penambahan pihak ketiga.

Sintaks

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

Parameter

hCall

Tangani ke Panggilan awal yang mengidentifikasi pihak pertama panggilan konferensi. Di beberapa lingkungan (seperti yang dijelaskan dalam kemampuan perangkat), panggilan harus ada untuk memulai panggilan konferensi, dan aplikasi harus menjadi pemilik panggilan ini. Di lingkungan telepon lainnya, tidak ada panggilan awalnya, hCall harus dibiarkan NULL, dan hLine harus ditentukan untuk mengidentifikasi garis tempat panggilan konferensi akan dimulai. Status panggilan hCall harus tersambung.

hLine

Tangani ke garis. Handel ini digunakan untuk mengidentifikasi perangkat baris tempat asal panggilan konferensi jika hCallADALAH NULL. Parameter hLine diabaikan jika hCall bukan NULL.

lphConfCall

Penunjuk ke handel HCALL. Lokasi ini kemudian dimuat dengan handel yang mengidentifikasi panggilan konferensi yang baru dibuat. Aplikasi ini adalah pemilik satu-satunya dari panggilan ini. Status panggilan hConfCall tidak berlaku.

lphConsultCall

Penunjuk ke handel HCALL. Saat menyiapkan panggilan untuk penambahan pihak baru, panggilan sementara baru (panggilan konsultasi) dialokasikan secara otomatis. Awalnya, aplikasi adalah pemilik satu-satunya untuk panggilan ini.

dwNumParties

Jumlah pihak yang diharapkan dalam panggilan konferensi. Nomor ini diteruskan ke penyedia layanan. Penyedia layanan bebas untuk melakukan apa yang diinginkan dengan nomor ini: abaikan, gunakan sebagai petunjuk untuk mengalokasikan jembatan konferensi ukuran yang tepat di dalam sakelar, dan sebagainya.

lpCallParams

Penunjuk ke struktur LINECALLPARAMS yang berisi parameter panggilan untuk digunakan saat membuat panggilan konsultasi. Parameter ini dapat diatur ke NULL jika tidak ada parameter penyiapan panggilan khusus yang diinginkan.

Menampilkan nilai

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron, atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan LINE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

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.

Keterangan

Jika LINEERR_INVALLINESTATE dikembalikan, baris saat ini tidak dalam keadaan di mana operasi ini dapat dilakukan. Daftar operasi yang saat ini valid dapat ditemukan di anggota dwLineFeatures (dari jenis LINEFEATURE) dalam struktur LINEDEVSTATUS . (Baris panggilanGetLineDevStatus memperbarui informasi di LINEDEVSTATUS.) Jika LINEERR_INVALMEDIAMODE dikembalikan, periksa jenis media yang didukung pada baris di anggota dwMediaModes dalam struktur LINEDEVCAPS .

Fungsi lineSetupConference menyediakan dua cara untuk membuat panggilan konferensi baru, tergantung pada apakah panggilan dua pihak normal diperlukan untuk melakukan pra-ada atau tidak. Saat menyiapkan panggilan konferensi dari panggilan dua pihak yang ada, parameter hCall adalah handel panggilan valid yang awalnya ditambahkan ke panggilan konferensi oleh permintaan lineSetupConference ; hLine diabaikan. Pada tombol di mana penyetelan panggilan konferensi tidak dimulai dengan panggilan yang ada, hCall harus NULL dan hLine harus ditentukan untuk mengidentifikasi perangkat baris tempat memulai panggilan konferensi. Dalam kedua kasus, panggilan konsultasi dialokasikan untuk terhubung ke pihak yang akan ditambahkan ke panggilan. Aplikasi kemudian dapat menggunakan lineDial untuk memanggil alamat pihak lain.

Panggilan konferensi biasanya beralih ke status onHoldPendingConference , panggilan konsultasi ke status dialtone , dan panggilan awal (jika ada) ke status konferensi .

Panggilan konferensi juga dapat disiapkan oleh lineCompleteTransfer yang diselesaikan menjadi konferensi tiga arah. Aplikasi mungkin dapat beralih antara panggilan konsultasi dan panggilan konferensi menggunakan lineSwapHold.

Panggilan konsultasi dapat dibatalkan dengan memanggil lineDrop di atasnya. Saat menjatuhkan panggilan konsultasi, panggilan konferensi yang ada biasanya beralih kembali ke status tersambung . Aplikasi harus mengamati pesan LINE_CALLSTATE untuk menentukan dengan tepat apa yang terjadi pada panggilan. Misalnya, jika panggilan konferensi kembali ke panggilan dua pihak biasa, panggilan konferensi menjadi menganggur dan panggilan peserta asli dapat kembali tersambung.

Jika aplikasi menentukan handel panggilan asli (hCall) dalam panggilan ke fungsi lineUnhold , panggilan konferensi dan panggilan konsultasi biasanya diam.