fungsi lineGetNumRings (tapi.h)

Artikel
03/04/2024

Fungsi lineGetNumRings menentukan jumlah dering panggilan masuk pada alamat yang diberikan harus berdering sebelum menjawab panggilan.

Sintaks

LONG lineGetNumRings(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPDWORD lpdwNumRings
);

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.

lpdwNumRings

Jumlah cincin yang merupakan minimum dari semua permintaan lineSetNumRings saat ini.

Nilai kembali

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

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

Keterangan

Fungsi lineGetNumRings dan lineSetNumRings , saat digunakan dalam kombinasi, menyediakan mekanisme untuk mendukung implementasi fitur penghemat tol di beberapa aplikasi independen.

Aplikasi yang menerima handel untuk panggilan dalam status penawaran dan 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. Fungsi lineGetNumRings mengembalikan jumlah minimum semua cincin aplikasi yang ditentukan oleh lineSetNumRings. Karena nomor ini dapat bervariasi secara dinamis, aplikasi harus memanggil lineGetNumRings setiap kali memiliki opsi untuk menjawab panggilan. Jika tidak ada aplikasi yang disebut lineSetNumRings, jumlah cincin yang dikembalikan 0xFFFFFFFF. Pesan dering LINE_LINEDEVSTATE terpisah dikirim ke aplikasi untuk setiap siklus cincin.

Jika klasifikasi panggilan dilakukan oleh TAPI untuk menjawab semua panggilan mode media yang tidak diketahui dan memfilter aliran media, TAPI juga menghormati nomor ini.

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