TSPI_lineSetStatusMessages (tspi.h)

Artikel
03/13/2024

Fungsi TSPI_lineSetStatusMessages memungkinkan TAPI menentukan pesan pemberitahuan mana yang harus dihasilkan penyedia layanan untuk peristiwa yang terkait dengan perubahan status untuk baris yang ditentukan atau alamatnya.

Sintaks

LONG TSPIAPI TSPI_lineSetStatusMessages(
  HDRVLINE hdLine,
  DWORD    dwLineStates,
  DWORD    dwAddressStates
);

Parameter

hdLine

Handel ke perangkat baris tempat filter baru akan diatur.

dwLineStates

Array bit yang mengidentifikasi status perangkat baris mana yang mengubah pesan akan dikirim ke TAPI. Parameter ini menggunakan salah satu konstanta LINEDEVSTATE_.

dwAddressStates

Array bit yang mengidentifikasi status alamat mana yang mengubah pesan akan dikirim ke TAPI. Parameter ini menggunakan salah satu konstanta LINEADDRESSSTATE_.

Nilai kembali

Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINESTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Keterangan

Penyedia layanan mengembalikan LINEERR_INVALLINESTATE jika parameter dwLineStates berisi satu atau beberapa bit yang tidak LINEDEVSTATE_ konstanta.

Telepon mendefinisikan sejumlah pesan yang memberi tahu aplikasi tentang peristiwa yang terjadi pada baris dan alamat. Kumpulan semua pesan perubahan di mana semua aplikasi yang tertarik bisa jauh lebih kecil dari kumpulan pesan yang mungkin. Prosedur ini memungkinkan TAPI untuk memberi tahu penyedia layanan tentang pengurangan kumpulan pesan yang akan dikirimkan. Penyedia layanan mengirimkan semua pesan yang didukungnya, dalam set yang ditentukan. Diizinkan untuk mengirimkan lebih banyak (mereka difilter oleh TAPI), tetapi tidak disarankan untuk melakukannya karena alasan performa. Jika TAPI meminta pengiriman jenis pesan tertentu yang tidak diproduksi oleh penyedia, penyedia tetap menerima permintaan tetapi tidak menghasilkan pesan. Secara default, pelaporan status alamat dan baris awalnya dinonaktifkan untuk baris.

Fungsi ini berbeda dari fungsi TAPI yang sesuai sebagai berikut: (1) Kumpulan pesan yang diminta adalah penyatuan semua set yang diminta oleh aplikasi di tingkat TAPI. (2) Kumpulan pesan tidak dikurangi atau ditambahkan oleh kepemilikan (karena tidak ada konsep kepemilikan di tingkat TSPI) (3) Set ini adalah saran dalam arti bahwa penyedia layanan diperlukan untuk meneruskan setidaknya set pesan yang ditunjukkan tetapi diizinkan untuk meneruskan set yang lebih besar.

Perubahan status perangkat mengenai Buka dan Tutup tidak dilaporkan, karena pada tingkat TSPI hanya ada satu Buka yang luar biasa pada satu waktu.