pesan LINE_NEWCALL
Pesan LINE_NEWCALL TSPI dikirim ke fungsi panggilan balik LINEEVENT setiap kali panggilan baru yang belum berasal DARI TAPI tiba di jalur yang dibuka TAPI. Ini harus menjadi pesan pertama yang dikirim mengenai panggilan itu. TAPI menulis handel buram htCall ke lokasi yang diteruskan oleh penyedia layanan sebagai dwParam2. Ini memberi penyedia layanan nilai htCall yang akan digunakan dalam pesan berikutnya.
Parameter
-
htLine
-
Handel objek BURAM TAPI ke perangkat garis.
-
htCall
-
Tidak digunakan.
-
dwMsg
-
Nilai LINE_NEWCALL.
-
dwParam1
-
Handel buram penyedia layanan untuk panggilan, jenis HDRVCALL. TAPI meneruskan nilai ini sebagai parameter hdCall untuk mengidentifikasi panggilan dalam prosedur berikutnya yang dipanggilnya untuk beroperasi pada panggilan.
-
dwParam2
-
Penunjuk jenis LPHTAPICALL menunjuk ke HTAPICALL. TAPI menulis handel BURAM TAPI untuk panggilan ke lokasi yang ditunjukkan. Penyedia layanan harus menyimpan nilai ini dan meneruskannya sebagai parameter htCall untuk mengidentifikasi panggilan dalam peristiwa berikutnya yang dilaporkannya untuk panggilan.
Parameter ini juga dapat memperoleh nilai NULL (lihat bagian Keterangan berikut).
-
dwParam3
-
Tidak digunakan.
Keterangan
Penyedia layanan harus mengirim pesan LINE_CALLSTATE sebagai pesan berikutnya untuk panggilan ini. Peristiwa LINE_NEWCALL tidak biasa karena juga meneruskan nilai kembali ke penyedia layanan.
Fungsi ini melaporkan setiap panggilan baru yang berasal dari penyedia layanan (masuk, keluar, dimulai di telepon, dan sebagainya) di mana TAPI dan penyedia layanan belum bertukar handel buram. Handel ditukar sehingga TAPI dan penyedia layanan kemudian dapat membuat permintaan dan melaporkan peristiwa yang melibatkan panggilan. Karena panggilan baru ini belum tentu masuk, panggilan awalnya dapat berada dalam status apa pun, belum tentu status penawaran . Jika penyedia layanan memulai dan menemukan bahwa satu atau beberapa panggilan sudah aktif di jalur, ia memberi tahu TAPI tentang mereka dengan pesan LINE_NEWCALL diikuti dengan pesan LINE_CALLSTATE yang menunjukkan status saat ini. Panggilan keluar baru, yang dimulai di telepon oleh pengguna, akan dilaporkan dengan pesan LINE_NEWCALL , dan pesan LINE_CALLSTATE awal akan menunjukkan bahwa panggilan berada dalam status DIALTONE (dan kemudian melanjutkan dari sana).
Jika penyedia layanan melewati sejumlah besar panggilan ke TAPI dalam waktu yang sangat singkat (selama siklus interupsi yang sama), TAPI dapat menjadi backlogged dalam memproses panggilan tersebut. Ketika ini terjadi, TAPI memberi sinyal kepada penyedia layanan untuk menunggu beberapa saat sebelum mengirim panggilan lagi. Ini menandakan ini dengan menulis nilai NULL, alih-alih HTAPICALL yang valid, ke lokasi yang diarahkan oleh parameter dwParam2dari LINE_NEWCALL. Ini menunjukkan bahwa upaya untuk memproses handel panggilan yang baru ditawarkan tidak berhasil, kemungkinan besar karena ketidakmampuan sementara untuk mengalokasikan memori. Penyedia layanan dapat merespons dengan menghilangkan panggilan atau dengan mengirim ulang pesan LINE_NEWCALL setelah penundaan penjadwalan (selama waktu itu penyedia layanan harus menghasilkan prosesor untuk memungkinkan TAPI memproses tindakan lain yang tertunda). Bagaimanapun, tidak ada pesan lebih lanjut mengenai panggilan baru yang dapat diteruskan ke TAPI sampai pertukaran handel berhasil. Ketika lokasi yang diarahkan oleh dwParam2 memperoleh nilai non-NULL , penyedia layanan tahu bahwa nilai ini adalah handel HTAPICALL yang valid ke panggilan.
Tidak ada pesan yang sesuai langsung di tingkat TAPI. Pesan ini digunakan di tingkat TSPI untuk secara unik dan tidak ambigu memperkenalkan panggilan masuk baru ke TAPI dan mengambil pengidentifikasi BURAM TAPI untuk panggilan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Versi TAPI |
Membutuhkan TAPI 2.0 atau yang lebih baru |
| Header |
|