fungsi lineGetNumRings (tapi.h)

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

Sintaksis

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.

Mengembalikan nilai

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

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

Komentar

LineGetNumRings dan lineSetNumRings fungsi, ketika 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 dering LINE_LINEDEVSTATEharus menunggu sejumlah cincin yang sama dengan nomor yang dikembalikan oleh baris GetNumRings 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 memanggil 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 saluran.

 

Persyaratan

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

Lihat juga

Referensi Layanan Telepon Dasar

LINE_LINEDEVSTATE

Gambaran Umum Referensi TAPI 2.2

lineSetNumRings