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

Lihat juga

LINEMONITORTONE

Fungsi Layanan Garis Tambahan

Gambaran Umum Referensi TAPI 2.2