fungsi lineMonitorDigits (tapi.h)

Artikel
03/08/2023

Fungsi lineMonitorDigits memungkinkan dan menonaktifkan deteksi digit yang tidak dibuffer yang diterima pada panggilan. Setiap kali digit mode digit yang ditentukan terdeteksi, pesan dikirim ke aplikasi yang menunjukkan digit mana yang telah terdeteksi.

Sintaks

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

Parameter

hCall

Tangani ke panggilan tempat digit akan terdeteksi. Status panggilan hCall dapat menjadi status apa pun kecuali diam atau terputus.

dwDigitModes

Mode digit atau mode yang akan dipantau. Jika dwDigitModes adalah nol, pemantauan digit dibatalkan. Parameter ini menggunakan satu atau beberapa konstanta LINEDIGITMODE_.

Nilai kembali

Mengembalikan nol jika permintaan berhasil atau nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALDIGITMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Keterangan

Fungsi ini dianggap berhasil jika pemantauan digit telah dimulai dengan benar, bukan ketika pemantauan digit telah dihentikan. Pemantauan digit tetap berlaku sampai secara eksplisit dinonaktifkan dengan memanggil lineMonitorDigits dengan dwDigitModes diatur ke nol, sampai panggilan beralih ke diam, atau ketika aplikasi membatalkan handel panggilannya untuk panggilan. Meskipun fungsi ini dapat dipanggil dalam status panggilan apa pun, digit biasanya hanya terdeteksi saat panggilan dalam status tersambung .

Setiap kali digit terdeteksi, pesan LINE_MONITORDIGITS dikirim ke aplikasi yang meneruskan digit yang terdeteksi sebagai parameter.

Aplikasi dapat menggunakan lineMonitorDigits untuk mengaktifkan atau menonaktifkan deteksi digit yang tidak dibuffer. Ini dapat menggunakan lineGatherDigits untuk deteksi digit buffer. Setelah pengumpulan digit buffer selesai, pesan LINE_GATHERDIGITS dikirim ke aplikasi. Deteksi digit yang di-buffer dan tidak dibuffer dapat diaktifkan pada panggilan yang sama secara bersamaan.

Pemantauan digit pada panggilan konferensi hanya berlaku untuk hConfCall, bukan untuk panggilan yang berpartisipasi individu.