fungsi lineSetNumRings (tapi.h)

Artikel
03/04/2024

Fungsi lineSetNumRings mengatur jumlah cincin yang harus terjadi sebelum panggilan masuk dijawab. Fungsi ini dapat digunakan untuk mengimplementasikan fungsi gaya toll-saver. Ini memungkinkan beberapa aplikasi independen untuk masing-masing mendaftarkan jumlah cincin. Baris fungsiGetNumRings mengembalikan jumlah minimum cincin yang diminta. Ini dapat digunakan oleh aplikasi yang menjawab panggilan masuk untuk menentukan jumlah dering yang harus ditunggu sebelum menjawab panggilan.

Sintaks

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

Parameter

hLine

Tangani ke perangkat baris terbuka.

dwAddressID

Alamat pada perangkat baris. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

dwNumRings

Jumlah dering sebelum panggilan harus dijawab untuk mematuhi permintaan penghemat tol dari semua aplikasi.

Nilai kembali

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Keterangan

Fungsi lineGetNumRings dan lineSetNumRings , saat digunakan dalam kombinasi, menyediakan mekanisme untuk mendukung implementasi fitur penghemat tol di beberapa aplikasi independen. Jika tidak ada aplikasi yang memanggil lineSetNumRings, lineGetNumRings mengembalikan 0xFFFFFFFF.

Aplikasi yang merupakan pemilik panggilan dalam status penawaran dan yang menerima pesan deringLINE_LINEDEVSTATE harus menunggu sejumlah cincin yang sama dengan nomor yang dikembalikan oleh lineGetNumRings sebelum menjawab panggilan untuk menghormati pengaturan penghemat tol di semua aplikasi. Pesan dering LINE_LINEDEVSTATE terpisah dikirim ke aplikasi untuk setiap siklus cincin, sehingga aplikasi harus menghitung pesan ini. Jika panggilan ini terputus sebelum dijawab, dan panggilan lain segera masuk setelahnya, pesan LINE_CALLSTATE harus memungkinkan aplikasi untuk menentukan bahwa dering terkait dengan panggilan kedua.

Jika klasifikasi panggilan dilakukan oleh TAPI dengan cara menjawab panggilan masuk dari jenis media yang tidak diketahui dan memfilter aliran media, TAPI juga menghormati nomor ini.

Catatan Operasi ini murni informasional dan tidak memengaruhi status panggilan apa pun pada perangkat baris.