pesan LINE_APPNEWCALL

Pesan tapi LINE_APPNEWCALL dikirim untuk menginformasikan aplikasi ketika handel panggilan baru telah dibuat secara spontan atas namanya (selain melalui panggilan API dari aplikasi, dalam hal ini handel akan dikembalikan melalui parameter pointer yang diteruskan ke fungsi).

        

Parameter

hDevice

Handel aplikasi ke perangkat baris tempat panggilan telah dibuat.

dwCallbackInstance

Instans panggilan balik disediakan saat membuka baris panggilan.

dwParam1

Pengidentifikasi alamat pada baris tempat panggilan muncul. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

dwParam2

Aplikasi menangani panggilan baru.

dwParam3

Hak istimewa aplikasi untuk panggilan baru (LINECALLPRIVILEGE_OWNER atau LINECALLPRIVILEGE_MONITOR).

Mengembalikan nilai

Tidak ada nilai yang ditampilkan.

Keterangan

Aplikasi yang mendukung TAPI versi 2.0 atau yang lebih baru dikirim pesan LINE_APPNEWCALL setiap kali aplikasi secara spontan diberikan handel ke panggilan baru. Karena pesan menyertakan parameter hLine dan dwAddressID tempat panggilan ada, aplikasi dapat dengan mudah membuat objek panggilan baru dalam konteks yang benar. Pesan LINE_APPNEWCALL selalu diikuti oleh pesan LINE_CALLSTATE yang menunjukkan status awal panggilan.

Aplikasi lama (yang menegosiasikan versi API yang lebih lama dari 2.0) hanya dikirim LINE_CALLSTATE pesan, seperti yang didokumentasikan dalam versi API sebelumnya. Aplikasi tersebut akan membuat objek panggilan baru setelah menerima pesan LINE_CALLSTATE yang memiliki dwParam3 diatur ke nilai bukan nol dan berisi handel panggilan yang saat ini tidak diketahui oleh aplikasi. Kerugiannya adalah bahwa (a) aplikasi harus memanggil lineGetCallInfo untuk menentukan parameter hLine dan dwAddressID yang terkait dengan panggilan; (b) aplikasi harus memindai semua handel panggilan yang diketahui untuk menentukan bahwa panggilan adalah panggilan baru; dan (c) dimungkinkan, dalam kondisi tertentu, agar aplikasi berpikir menerima handel panggilan baru ketika pada kenyataannya baru saja membatalkan alokasi handelnya ke panggilan (misalnya, aplikasi baru saja membatalkan alokasi handel panggilan, tetapi pesan LINE_CALLSTATE memberikan kepemilikan aplikasi panggilan karena lineHandoff dari aplikasi lain sudah berada dalam antrean pesan TAPI aplikasi).

Persyaratan

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

Lihat juga

LINE_CALLSTATE

lineGetCallInfo

lineHandoff