LINE_GATHERDIGITS pesan

Artikel
06/13/2023

Pesan TAPI LINE_GATHERDIGITS dikirim ketika permintaan pengumpulan digit yang di-buffer saat ini telah dihentikan atau dibatalkan. Buffer digit dapat diperiksa setelah pesan ini diterima oleh aplikasi.

Parameter

hDevice: Handel ke panggilan.
dwCallbackInstance: Instans panggilan balik disediakan saat membuka baris.
dwParam1: Alasan mengapa pengumpulan digit dihentikan. Parameter ini harus satu dan hanya satu dari konstanta LINEGATHERTERM_.
dwParam2: Tidak digunakan.
dwParam3: "Jumlah centang" (jumlah milidetik sejak Windows dimulai) tempat pengumpulan digit selesai. Untuk versi TAPI yang lebih lama dari 2.0, parameter ini tidak digunakan.

Menampilkan nilai

Tidak ada nilai yang ditampilkan.

Keterangan

Pesan LINE_GATHERDIGITS hanya dikirim ke aplikasi yang memulai pengumpulan digit pada panggilan menggunakan lineGatherDigits.

Jika fungsi lineGatherDigits digunakan untuk membatalkan permintaan sebelumnya untuk mengumpulkan digit, TAPI mengirim pesan LINE_GATHERDIGITS dengan dwParam1 diatur ke LINEGATHERTERM_CANCEL ke aplikasi yang menunjukkan bahwa buffer yang awalnya ditentukan berisi digit yang dikumpulkan hingga pembatalan.

Karena tanda waktu yang ditentukan oleh dwParam3 mungkin telah dibuat pada komputer selain yang dijalankan aplikasi, ini hanya berguna untuk perbandingan dengan pesan bertanda waktu serupa lainnya yang dihasilkan pada perangkat baris yang sama ( LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_MONITORTONE), untuk menentukan waktu relatif mereka (pemisahan antara peristiwa). Jumlah tick dapat "membungkus" setelah sekitar 49,7 hari; aplikasi harus memperhitungkan hal ini saat melakukan penghitungan.

Jika penyedia layanan tidak menghasilkan tanda waktu (misalnya, jika dibuat menggunakan versi TAPI yang lebih lama), maka TAPI menyediakan tanda waktu pada titik yang paling dekat dengan penyedia layanan yang menghasilkan peristiwa sehingga tanda waktu yang disintesis seakurat mungkin.

Catatan

Ketika aplikasi memanggil operasi asinkron apa pun yang menulis data kembali ke memori aplikasi, aplikasi harus menjaga memori tersebut tersedia untuk ditulis hingga pesan LINE_REPLY atau LINE_GATHERDIGITS diterima.

Persyaratan

Persyaratan	Nilai
Versi TAPI	Membutuhkan TAPI 2.0 atau yang lebih baru
Header	Tapi.h

Lihat juga

LINE_GENERATE
LINE_MONITORDIGITS
LINE_MONITORMEDIA
LINE_MONITORTONE
LINE_REPLY
lineGatherDigits