LINE_CALLSTATE pesan

Pesan LINE_CALLSTATE TAPI dikirim ketika status panggilan yang ditentukan telah berubah. Biasanya, beberapa pesan tersebut diterima selama masa pakai panggilan. Aplikasi diberi tahu tentang panggilan masuk baru dengan pesan ini; panggilan baru dalam status penawaran . Aplikasi dapat menggunakan lineGetCallStatus untuk mengambil informasi lebih rinci tentang status panggilan saat ini.

Parameter

hDevice

Handel ke panggilan.

dwCallbackInstance

Instans panggilan balik disediakan saat membuka baris panggilan.

dwParam1

Status panggilan baru. Parameter ini harus satu dan hanya salah satu konstanta LINECALLSTATE_ berikut.

dwParam1	Makna
LINECALLSTATE_BUSY	dwParam2 berisi detail tentang mode sibuk. Parameter ini menggunakan salah satu konstanta LINEBUSYMODE_.
LINECALLSTATE_CONNECTED	dwParam2 berisi detail tentang mode terhubung. Parameter ini menggunakan salah satu konstanta LINECONNECTEDMODE_.
LINECALLSTATE_DIALTONE	dwParam2 berisi detail tentang mode nada putar nomor. Parameter ini menggunakan salah satu konstanta LINEDIALTONEMODE_.
LINECALLSTATE_OFFERING	dwParam2 berisi detail tentang mode terhubung. Parameter ini menggunakan salah satu konstanta LINEOFFERINGMODE_.
LINECALLSTATE_SPECIALINFO	dwParam2 berisi detail tentang mode informasi khusus. Parameter ini menggunakan salah satu konstanta LINESPECIALINFO_.
LINECALLSTATE_DISCONNECTED	dwParam2 berisi detail tentang mode pemutusan sambungan. Parameter ini menggunakan salah satu konstanta LINEDISCONNECTMODE_.

dwParam2

Informasi yang bergantung pada status panggilan. Lihat dwParam1.

Catatan

Dalam keadaan di mana respons tertunda sesuai, gunakan LINEDISCONNECTMODE_TEMPFAILURE. Jika respons yang diblokir sesuai, gunakan LINEDISCONNECT_BLOCKED. Untuk informasi lebih lanjut, lihat konstanta LINEDISCONNECTMODE_.

Jika dwParam1 LINECALLSTATE_CONFERENCED, dwParam2 berisi parameter hConfCall dari panggilan induk konferensi tempat subjek hCall adalah anggota. Jika panggilan yang ditentukan dalam dwParam2 sebelumnya tidak dianggap oleh aplikasi sebagai panggilan konferensi induk (hConfCall, aplikasi harus melakukannya sebagai akibat dari pesan ini. Jika aplikasi tidak memiliki handel ke panggilan induk konferensi (karena sebelumnya disebut lineDeallocateCall pada handel tersebut) dwParam2 diatur ke NULL.

dwParam3

Jika nol, parameter ini menunjukkan bahwa belum ada perubahan dalam hak istimewa aplikasi untuk panggilan.

Jika bukan nol, itu menentukan hak istimewa aplikasi untuk panggilan. Ini terjadi dalam situasi berikut: (1) Pertama kali aplikasi diberikan handel untuk panggilan ini; (2) Ketika aplikasi adalah target handoff panggilan (bahkan jika aplikasi sudah menjadi pemilik panggilan). Parameter ini menggunakan salah satu konstanta LINECALLPRIVILEGE_ berikut.

Menampilkan nilai

Tidak ada nilai yang ditampilkan.

Keterangan

Pesan ini dikirim ke aplikasi apa pun yang memiliki handel untuk panggilan. Pesan LINE_CALLSTATE juga memberi tahu aplikasi yang memantau panggilan pada baris tentang keberadaan dan status panggilan keluar yang dibuat oleh aplikasi lain atau secara manual oleh pengguna (misalnya, pada perangkat telepon yang terpasang). Status panggilan panggilan tersebut mencerminkan status panggilan aktual, yang tidak ditawarkan. Dengan memeriksa status panggilan, aplikasi dapat menentukan apakah panggilan adalah panggilan masuk yang perlu dijawab atau tidak.

Pesan LINE_CALLSTATE dengan status panggilan yang tidak diketahui dapat dikirim ke aplikasi pemantauan sebagai hasil dari lineMakeCall, lineForward, lineUnpark, lineSetupTransfer, linePickup, lineSetupConference, atau linePrepareAddToConference yang telah diminta oleh aplikasi lain. Pada saat yang sama aplikasi yang meminta dikirim LINE_REPLY (berhasil) untuk operasi yang diminta, aplikasi pemantauan apa pun di baris dikirimi pesan LINE_CALLSTATE (tidak diketahui). Pesan LINE_CALLSTATE yang menunjukkan status panggilan "nyata" dari panggilan yang baru dibuat dikirim (menggunakan informasi yang disediakan oleh penyedia layanan) ke aplikasi yang meminta dan memantau segera setelahnya.

Pesan LINE_CALLSTATE (tidak diketahui) dikirim ke aplikasi pemantauan hanya jika lineCompleteTransfer menyebabkan panggilan diselesaikan ke dalam konferensi tiga arah.

Untuk kompatibilitas mundur, aplikasi lama tidak mengharapkan nilai tertentu dalam dwParam2 dari pesan LINECALLSTATE_CONFERENCED. Oleh karena itu, TAPI meneruskan panggilan induk hConfCall di dwParam2 terlepas dari versi API aplikasi yang menerima pesan. Dalam kasus panggilan konferensi yang dimulai oleh penyedia layanan, aplikasi yang lebih lama tidak menyadari bahwa panggilan induk telah menjadi panggilan konferensi kecuali terjadi secara spontan memeriksa informasi lain (misalnya, panggil lineGetConfRelatedCalls).

Pesan ini tidak dapat dinonaktifkan.

Persyaratan

Persyaratan	Nilai
Versi TAPI	Membutuhkan TAPI 2.0 atau yang lebih baru
Header	Tapi.h

Lihat juga

LINE_REPLY

lineCompleteTransfer

lineDeallocateCall

LINEDIALPARAMS

lineForward

lineGenerateDigits

lineGetCallStatus

lineGetConfRelatedCalls

lineMakeCall

linePickup

linePrepareAddToConference

lineSetupTransfer

lineUnpark