Notifikasi Kejadian

Pemberitahuan peristiwa adalah cara utama di mana aplikasi mendapatkan informasi dari TAPI dan penyedia layanan. Informasi ini mungkin status operasi asinkron yang diinstigasi oleh aplikasi atau mungkin menyangkut proses yang dimulai di luar aplikasi, seperti pemberitahuan panggilan masuk baru.

TAPI 2.x: Aplikasi menangani pemberitahuan dengan salah satu dari tiga cara: Jendela Tersembunyi, Penanganan Peristiwa, atau Port Penyelesaian. Untuk informasi tambahan tentang mekanisme pemberitahuan ini, silakan lihat bagian Keterangan untuk lineInitializeEx. Aplikasi menentukan mekanisme dengan mengatur anggota dwOptions dari struktur LINEINITIALIZEEXPARAMS sebelum memanggil lineInitializeEx.

Fungsi lineSetStatusMessages memungkinkan aplikasi menentukan pesan pemberitahuan mana yang akan diterima untuk peristiwa yang terkait dengan perubahan status untuk baris yang ditentukan atau alamatnya.

TAPI 3.x: Aplikasi menangani pemberitahuan umum menggunakan objek yang dapat dihubungkan standar COM. ITTAPIEventNotification adalah antarmuka keluar yang harus didaftarkan dengan objek kontainer TAPI, dan ITTAPIEventNotification::Event adalah metode panggilan TAPI untuk menentukan respons aplikasi. Metode ITTAPI::p ut_EventFilter memberi tahu TAPI peristiwa mana yang menarik bagi aplikasi. Jika filter peristiwa tidak dimasukkan, aplikasi tidak akan menerima pemberitahuan tentang peristiwa apa pun. Metode ITTAPI::RegisterCallNotifications memberi tahu TAPI jenis dan alamat media tempat aplikasi akan menangani sesi masuk. Untuk informasi tambahan tentang penanganan peristiwa TAPI 3, lihat Gambaran umum peristiwa atau contoh kode Daftarkan Peristiwa .

Penyedia layanan telepon menerapkan TSPI_lineSetDefaultMediaDetection dan TSPI_lineSetStatusMessages. TAPI memanggil fungsi-fungsi ini untuk menunjukkan kumpulan semua peristiwa baris, alamat, dan jenis media yang diminta oleh aplikasi.