fungsi lineMonitorTones (tapi.h)
Fungsi lineMonitorTones memungkinkan dan menonaktifkan deteksi nada inband pada panggilan. Setiap kali nada tertentu terdeteksi, pesan dikirim ke aplikasi.
Sintaks
LONG lineMonitorTones(
HCALL hCall,
LPLINEMONITORTONE const lpToneList,
DWORD dwNumEntries
);
Parameter
hCall
Tangani panggilan pada nada saluran suara yang akan dipantau. Status panggilan hCall dapat menjadi status apa pun kecuali diam.
lpToneList
Daftar nada yang akan dipantau. Parameter ini berjenis LINEMONITORTONE. Setiap nada dalam daftar ini memiliki bidang tag yang ditentukan aplikasi yang digunakan untuk mengidentifikasi nada individual dalam daftar untuk melaporkan deteksi nada. Pemantauan nada yang sedang berlangsung dibatalkan atau diubah dengan memanggil operasi ini dengan NULL untuk lpToneList atau dengan daftar nada lain.
dwNumEntries
Jumlah entri dalam lpToneList. Parameter ini diabaikan jika lpToneList adalah NULL.
Nilai kembali
Mengembalikan nol jika permintaan berhasil atau nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:
LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_INVALTONE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Keterangan
Fungsi ini berhasil jika pemantauan nada telah dimulai dengan benar, bukan ketika pemantauan nada telah dihentikan. Pemantauan nada tetap berlaku sampai secara eksplisit dinonaktifkan dengan memanggil lineMonitorTones dengan daftar nada lain (atau NULL), hingga panggilan beralih ke menganggur, atau ketika aplikasi membatalkan handel panggilannya untuk panggilan.
Meskipun fungsi ini dapat dipanggil dalam status panggilan apa pun, nada biasanya hanya dapat dideteksi saat panggilan dalam status tersambung . Deteksi nada biasanya memerlukan sumber daya komputasi. Tergantung pada penyedia layanan dan aktivitas lain yang bersaing untuk sumber daya tersebut, jumlah nada yang dapat dideteksi dapat bervariasi dari waktu ke waktu. Selain itu, jumlah sumber daya yang setara dapat dikonsumsi untuk memantau nada frekuensi tiga kali lipat versus tiga nada frekuensi tunggal. Jika sumber daya diatasi, kesalahan LINEERR_RESOURCEUNAVAIL dikembalikan.
Fungsi lineMonitorTones juga digunakan untuk mendeteksi keheningan. Keheningan ditentukan sebagai nada dengan frekuensi nol.
Pemantauan nada pada panggilan konferensi hanya berlaku untuk hConfCall, bukan untuk panggilan yang berpartisipasi individu
Jika nilai kesalahan LINEERR_INVALPOINTER dikembalikan, parameter lpToneList yang ditentukan tidak valid atau nilai yang ditentukan oleh parameter dwNumEntries terlalu besar.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | tapi.h |
| Pustaka | Tapi32.lib |
| DLL | Tapi32.dll |