fungsi TSPI_providerEnumDevices (tspi.h)

Artikel
03/13/2024

TAPI memanggil fungsi TSPI_providerEnumDevices sebelum TSPI_providerInit untuk menentukan jumlah perangkat saluran dan telepon yang didukung oleh penyedia layanan.

Sintaks

LONG TSPIAPI TSPI_providerEnumDevices(
  DWORD      dwPermanentProviderID,
  LPDWORD    lpdwNumLines,
  LPDWORD    lpdwNumPhones,
  HPROVIDER  hProvider,
  LINEEVENT  lpfnLineCreateProc,
  PHONEEVENT lpfnPhoneCreateProc
);

Parameter

dwPermanentProviderID

Pengidentifikasi permanen, unik dalam penyedia layanan pada sistem ini, dari penyedia layanan yang sedang diinisialisasi.

lpdwNumLines

Penunjuk ke lokasi memori berukuran DWORD tempat penyedia layanan harus menulis jumlah perangkat baris yang dikonfigurasi untuk didukung. TAPI menginisialisasi nilai ke 0, jadi jika penyedia layanan gagal menulis nilai yang berbeda, nilai 0 diasumsikan.

lpdwNumPhones

Pointer ke lokasi memori berukuran DWORD tempat penyedia layanan harus menulis jumlah perangkat telepon yang dikonfigurasi untuk didukung. TAPI menginisialisasi nilai ke 0, jadi jika penyedia layanan gagal menulis nilai yang berbeda, nilai 0 diasumsikan.

hProvider

Nilai berukuran DWORD buram yang secara unik mengidentifikasi instans penyedia layanan ini selama eksekusi lingkungan Telepon ini.

lpfnLineCreateProc

Penunjuk ke prosedur panggilan balik LINEEVENT yang disediakan oleh TAPI. Penyedia layanan menggunakan fungsi ini untuk mengirim pesan LINE_CREATE ketika perangkat baris baru perlu dibuat.

lpfnPhoneCreateProc

Penunjuk ke prosedur panggilan balik PHONEEVENT yang disediakan oleh TAPI. Penyedia layanan menggunakan fungsi ini untuk mengirim pesan PHONE_CREATE ketika perangkat telepon baru perlu dibuat.

Nilai kembali

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

LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Keterangan

Dalam versi TAPI sebelumnya, implementasi fungsi ini bersifat opsional. Dimulai dengan TAPI 2.0, implementasi fungsi ini wajib di semua penyedia layanan. TAPI tidak lagi memeriksa Telephon.ini atau Registri di startup TAPI untuk menentukan jumlah awal saluran dan telepon yang didukung oleh penyedia layanan.

Perangkat baru dapat muncul sebelum menyelesaikan prosedur TSPI_providerInit . TAPI menangani pesan _CREATE dengan benar selama inisialisasi penyedia.