TSPI_lineAddToConference (tspi.h)

Artikel
08/26/2023

Fungsi TSPI_lineAddToConference menambahkan panggilan yang ditentukan oleh hdConsultCall ke panggilan konferensi yang ditentukan oleh hdConfCall.

Sintaks

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

Parameter

dwRequestID

Pengidentifikasi permintaan asinkron.

hdConfCall

Pegangan ke panggilan konferensi. Status panggilan hdConfCall dapat berupa onHoldPendingConference atau onHold.

hdConsultCall

Handel ke panggilan untuk ditambahkan ke panggilan konferensi. Panggilan ini tidak boleh menjadi induk konferensi lain atau peserta dalam konferensi apa pun. Bergantung pada kemampuan perangkat yang ditunjukkan dalam LINEADDRESSCAPS, parameter hdConsultCall mungkin belum tentu dibuat menggunakan TSPI_lineSetupConference atau TSPI_linePrepareAddToConference. Status panggilan hdConsultCall dapat dihubungkan, onHold, melanjutkan, atau ringback.

Nilai kembali

Mengembalikan dwRequestID atau nomor kesalahan jika terjadi kesalahan. Parameter aktual lResult dari ASYNC_COMPLETION yang sesuai adalah nol jika fungsi berhasil atau nomor kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_CONFERENCEFULL, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Keterangan

Penyedia layanan mengembalikan LINEERR_INVALCALLHANDLE jika hdConsultCall adalah induk dari konferensi lain atau sudah menjadi peserta dalam konferensi, atau hdConsultCall tidak dapat ditambahkan karena alasan lain, seperti harus dibuat menggunakan TSPI_lineSetupConference atau TSPI_linePrepareAddToConference.

Catatan Handel panggilan pihak yang ditambahkan tetap valid setelah menambahkan panggilan ke konferensi; biasanya, statusnya berubah menjadi konferensi saat status panggilan konferensi tersambung. Handel ke panggilan yang berpartisipasi dapat digunakan nanti untuk menghapus pihak tersebut dari panggilan konferensi menggunakan TSPI_lineRemoveFromConference.

Status panggilan dari panggilan yang berpartisipasi dalam konferensi tidak independen. Misalnya, saat memutuskan panggilan konferensi, semua panggilan yang berpartisipasi dapat secara otomatis menganggur. TAPI dapat berkonsultasi dengan kemampuan perangkat baris untuk menentukan bentuk penghapusan konferensi apa yang tersedia. TAPI atau aplikasi kliennya harus melacak pesan LINE_CALLSTATE untuk menentukan apa yang terjadi pada panggilan yang terlibat.

Panggilan konferensi dibuat baik melalui TSPI_lineSetupConference atau TSPI_lineCompleteTransfer. Biasanya, panggilan yang ditambahkan ke konferensi dibuat menggunakan TSPI_lineSetupConference atau TSPI_linePrepareAddToConference. Beberapa sakelar mungkin memungkinkan penambahan panggilan arbitrer ke konferensi, dan panggilan semacam itu mungkin telah disiapkan menggunakan TSPI_lineMakeCall dan berada di penangguhan (keras). Semua panggilan yang merupakan bagian dari konferensi harus ada di baris terbuka yang sama.

Setiap pemantauan (media, nada, digit) pada panggilan konferensi hanya berlaku untuk parameter hdConfCall , bukan untuk panggilan yang berpartisipasi individu.

Fungsi ini tidak memiliki batasan berdasarkan hak istimewa seperti dalam fungsi yang sesuai di tingkat TAPI. Tidak ada persyaratan eksplisit bagi penyedia layanan untuk melacak hubungan antara panggilan konferensi "induk" dan pesertanya, karena tidak ada korespondensi TSPI dengan fungsi TAPI. Banyak penyedia layanan mungkin merasa perlu untuk melacak hubungan ini secara internal untuk mengimplementasikan fungsi manajemen panggilan konferensi lainnya.