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

Handel aplikasi ke panggilan baru.

dwParam3

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

Nilai kembali

Tidak ada nilai yang ditampilkan.

Keterangan

Aplikasi yang mendukung TAPI versi 2.0 atau yang lebih baru dikirimi 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 segera diikuti oleh pesan LINE_CALLSTATE yang menunjukkan status awal panggilan.

Aplikasi lama (yang menegosiasikan versi API yang lebih lama dari 2.0) hanya dikirimi pesan LINE_CALLSTATE , seperti yang didokumentasikan dalam versi API sebelumnya. Aplikasi tersebut akan membuat objek panggilan baru saat menerima pesan LINE_CALLSTATE yang memiliki dwParam3 yang 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, bagi aplikasi untuk 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 yang 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