TSPI_lineMonitorDigits (tspi.h)

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

Sintaks

LONG TSPIAPI TSPI_lineMonitorDigits(
  HDRVCALL hdCall,
  DWORD    dwDigitModes
);

Parameter

hdCall

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

dwDigitModes

Mode digit yang akan dipantau. Parameter dwDigitModes dengan nilai 0 membatalkan pemantauan digit. Parameter dwDigitModes dapat memiliki salah satu konstanta LINEDIGITMODE_.

Nilai kembali

Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

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

Keterangan

Fungsi ini mengembalikan nol (berhasil) ketika pemantauan digit dimulai dengan benar, bukan ketika pemantauan digit dihentikan. Pemantauan digit tetap berlaku sampai secara eksplisit dinonaktifkan oleh panggilan ke TSPI_lineMonitorDigits dengan dwDigitModes diatur ke nol, atau sampai panggilan beralih ke diam. Fungsi harus mengembalikan nol ketika pemantauan digit dibatalkan (yaitu, ketika parameter dwDigitModes adalah nol). Penyedia layanan harus mengakhiri pemantauan digit saat panggilan diam. TAPI tidak secara spontan memanggil TSPI_lineMonitorDigits untuk mengakhiri pemantauan.

Meskipun fungsi ini dapat dipanggil dalam status panggilan apa pun, digit biasanya hanya terdeteksi saat panggilan dalam status tersambung .

Setiap kali digit terdeteksi, penyedia layanan mengirim pesan LINE_MONITORDIGITS ke TAPI, meneruskan digit yang terdeteksi sebagai parameter. Jika LINEDIGITMODE_DTMF dan LINEDIGITMODE_DTMFEND diatur dalam dwDigitModes, dua pesan LINE_MONITORDIGITS dikirim untuk setiap digit.

TAPI dapat menggunakan TSPI_lineMonitorDigits untuk mengaktifkan atau menonaktifkan deteksi digit yang tidak dibuffer. Ini dapat menggunakan TSPI_lineGatherDigits untuk deteksi digit buffer. Setelah pengumpulan digit buffer selesai, pesan LINE_GATHERDIGITS dikirim. Deteksi digit yang di-buffer dan tidak dibuffer dapat diaktifkan pada panggilan yang sama secara bersamaan.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h

Lihat juga

LINEDEVCAPS

Konstanta LINEDIGITMODE_

LINE_GATHERDIGITS

LINE_MONITORDIGITS

TSPI_lineGatherDigits

TSPI_lineGetDevCaps

TSPI_lineSetMediaControl