fungsi lineGenerateDigitsA (tapi.h)

Fungsi lineGenerateDigits memulai pembuatan digit yang ditentukan pada panggilan yang ditentukan sebagai nada inband menggunakan mode sinyal yang ditentukan. Memanggil fungsi ini dengan nilai NULL untuk lpszDigits membatalkan pembuatan digit apa pun yang saat ini sedang berlangsung. Memanggil lineGenerateDigits atau lineGenerateTone saat pembuatan digit sedang berlangsung membatalkan pembuatan digit atau pembuatan nada saat ini dan memulai pembuatan digit atau nada yang terakhir ditentukan.

Sintaksis

LONG lineGenerateDigitsA(
  HCALL  hCall,
  DWORD  dwDigitMode,
  LPCSTR lpszDigits,
  DWORD  dwDuration
);

Parameter

hCall

Tangani ke panggilan. Aplikasi harus menjadi pemilik panggilan. Status panggilan hCall dapat menjadi status apa pun. TAPI tidak memberlakukan persyaratan callstate apa pun, namun beberapa Penyedia Layanan Tapi mungkin mengharuskan hCall berada dalam status LINECALLSTATE_CONNECTED.

dwDigitMode

Format yang akan digunakan untuk memberi sinyal digit ini. Ketahuilah bahwa dwDigitMode hanya dapat memiliki satu set bendera. Parameter ini menggunakan salah satuKonstanta LINEDIGITMODE_ .

lpszDigits

Penunjuk ke buffer karakter nulldihentikan yang berisi digit yang akan dihasilkan. Karakter yang valid adalah yang ditentukan untuk Konstanta LINEDIGITMODE_ yang disediakan dalam dwDigitModes.

Selain itu, koma (,) juga merupakan karakter yang valid. Koma menyuntikkan penundaan ekstra antara sinyal digit sebelumnya dan berikutnya yang dipisahkannya. Durasi jeda ini ditentukan konfigurasi, dan kemampuan perangkat baris menunjukkan durasi ini. Beberapa koma dapat digunakan untuk menyuntikkan jeda yang lebih lama. Digit yang tidak valid diabaikan selama pembuatan, bukan dilaporkan sebagai kesalahan.

Tanda seru (!) adalah karakter yang valid. Karakter ini menyebabkan operasi "hookflash", seperti yang dijelaskan untuk alamat yang dapat dialihkan.

dwDuration

Baik durasi dalam milidetik digit DTMF dan pulsa dan spasi antar digit DTMF. Nilai 0 menggunakan nilai default. Parameter dwDuration harus berada dalam rentang yang ditentukan oleh MinDialParams dan MaxDialParams di LINEDEVCAPS. Jika di luar rentang, nilai aktual diatur ke nilai terdekat dalam rentang.

Mengembalikan nilai

Mengembalikan nol jika permintaan berhasil atau angka kesalahan negatif jika terjadi kesalahan. Kemungkinan nilai pengembalian adalah:

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

Komentar

Fungsi lineGenerateDigits dianggap telah berhasil diselesaikan ketika pembuatan digit telah berhasil dimulai, bukan ketika semua digit telah dibuat. Berbeda denganlineDial , yang memanggil digit dengan cara yang bergantung pada jaringan, lineGenerateDigits menjamin untuk menghasilkan digit sebagai nada inband melalui saluran suara menggunakan DTMF atau pulsa panggilan hookswitch saat menggunakan pulsa. Fungsi lineGenerateDigits umumnya tidak cocok untuk melakukan panggilan atau panggilan. Ini ditujukan untuk sinyal end-to-end melalui panggilan yang ditetapkan.

Setelah semua digit dalam lpszDigits telah dibuat, atau setelah pembuatan digit dibatalkan atau dibatalkan, pesan LINE_GENERATE dikirim ke aplikasi.

Hanya satu permintaan pembuatan inband (pembuatan nada atau pembuatan digit) yang diizinkan untuk berlangsung per panggilan di semua aplikasi yang merupakan pemilik panggilan. Pembuatan digit pada panggilan dibatalkan dengan memulai permintaan pembuatan digit lain atau permintaan pembuatan nada. Untuk membatalkan pembuatan digit saat ini, aplikasi dapat memanggil lineGenerateDigits dan menentukan NULL untuk parameter lpszDigits.

Tergantung pada penyedia layanan dan perangkat keras, aplikasi dapat memantau digit yang dihasilkannya sendiri. Jika itu tidak diinginkan, aplikasi dapat menonaktifkan pemantauan digit saat menghasilkan digit.

Nota

Header tapi.h mendefinisikan lineGenerateDigits sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
Platform Target Windows
Header tapi.h
Pustaka Tapi32.lib
DLL Tapi32.dll

Lihat juga

LINEDEVCAPS

LINE_GENERATE

Fungsi Layanan Garis Tambahan

Gambaran Umum Referensi TAPI 2.2

lineDial

lineGenerateTone

  • Last updated on