ITLegacyCallMediaControl2::GatherDigits method (tapi3if.h)

Artikel
03/08/2023

Metode GatherDigits memulai pengumpulan digit pada panggilan yang ditentukan. Aplikasi menentukan jumlah maksimum digit yang akan dikumpulkan.

Sintaks

HRESULT GatherDigits(
  [in] TAPI_DIGITMODE DigitMode,
  [in] long           lNumDigits,
  [in] BSTR           pTerminationDigits,
  [in] long           lFirstDigitTimeout,
  [in] long           lInterDigitTimeout
);

Parameter

[in] DigitMode

Mode digit untuk dipantau. Parameter ini menentukan satu atau beberapa konstanta LINEDIGITMODE .

[in] lNumDigits

Jumlah digit yang akan dikumpulkan.

Jika parameter ini nol, metode membatalkan pengumpulan digit apa pun yang sedang berlangsung, tanpa memulai upaya pengumpulan digit baru. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] pTerminationDigits

Penunjuk ke representasi BSTR dari digit penghentian. Jika salah satu digit penghentian dalam string terdeteksi, digit tersebut ditambahkan ke buffer, koleksi digit dihentikan, dan peristiwa TE_GATHERDIGITS dikirim ke aplikasi.

[in] lFirstDigitTimeout

Lamanya waktu, dalam milidetik, di mana digit pertama diharapkan. Jika digit pertama tidak diterima dalam jangka waktu ini, koleksi digit dibatalkan dan peristiwa TE_GATHERDIGITS dikirim ke aplikasi. Buffer hanya berisi karakter NULL , yang menunjukkan bahwa tidak ada digit yang diterima dan bahwa pengumpulan digit-waktu habis digit pertama yang dihentikan. Batas waktu minimum dan maksimum yang dapat Anda tentukan ditemukan dalam kemampuan AC_GATHERDIGITSMINTIMEOUT dan AC_GATHERDIGITSMAXTIMEOUT.

[in] lInterDigitTimeout

Waktu maksimum, dalam milidetik, antara digit berturut-turut. Jika digit berikutnya tidak diterima dalam jangka waktu ini, koleksi digit dibatalkan dan peristiwa TE_GATHERDIGITS dikirim ke aplikasi. Buffer hanya berisi digit yang dikumpulkan hingga titik ini diikuti oleh karakter NULL , yang menunjukkan bahwa batas waktu antardigit menghentikan pengumpulan digit. Batas waktu minimum dan maksimum yang dapat ditentukan ditemukan dalam kemampuan AC_GATHERDIGITSMINTIMEOUT dan AC_GATHERDIGITSMAXTIMEOUT.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Parameter pTerminationDigits bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup untuk mengalokasikan buffer digit pengumpulan.
TAPI_E_INVALCALLSTATE	Panggilan harus dalam status tersambung .

Keterangan

Metode GatherDigits diterjemahkan ke panggilan ke TAPI 2. xfungsi lineGatherDigits .

Hanya satu panggilan GatherDigits yang dapat keluar pada panggilan. Jika Anda memanggil GatherDigits lagi, sebelum peristiwa TE_GATHERDIGITS terjadi, panggilan kedua membatalkan pengumpulan digit sebelumnya. Upaya pengumpulan digit yang dibatalkan mengirim peristiwa TE_GATHERDIGITS dengan digit yang dikumpulkan sejauh ini.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi3if.h
Pustaka	Uuid.lib
DLL	Tapi3.dll

Lihat juga

ITLegacyCallMediaControl2

Bagikan melalui