Kelas Perangkat TSPI

Kelas perangkat adalah sekelompok perangkat fisik atau driver perangkat terkait tempat aplikasi mengirim dan menerima informasi atau data yang melakukan panggilan. Setiap kelas perangkat memiliki nama kelas perangkat yang secara unik mengidentifikasi kelas dan memberikan informasi tentang antarmuka pemrograman dan perintah yang dapat digunakan untuk membuka dan berkomunikasi dengan perangkat di kelas.

Antarmuka Pemrograman Aplikasi Telepon (TAPI) mengaitkan perangkat dari satu atau beberapa kelas perangkat ke setiap saluran atau perangkat telepon. Anda mengakses salah satu perangkat ini dengan mengambil pengidentifikasi perangkat untuk perangkat menggunakan fungsi lineGetID atau phoneGetID . Anda menyediakan nama kelas perangkat, dan fungsi mengembalikan nama port, nama perangkat, handel perangkat, atau pengidentifikasi perangkat tertentu yang perlu Anda buka dan akses perangkat. Format informasi yang dikembalikan tergantung pada kelas perangkat dan dijelaskan di bagian ini.

Anda juga menggunakan nama kelas perangkat dengan fungsi lineConfigDialog dan phoneConfigDialog untuk memungkinkan pengguna mengatur opsi konfigurasi untuk perangkat tertentu; dengan fungsi lineGetIcon dan phoneGetIcon untuk mengambil ikon untuk mewakili perangkat yang diberikan; dan dengan fungsi lineGetDevConfig dan lineSetDevConfig untuk langsung mengambil dan mengatur opsi konfigurasi untuk perangkat tertentu.

Berikut ini adalah nama kelas perangkat default.

Nama kelas perangkat	Deskripsi
Comm	Port komunikasi
comm/datamodem	Modem melalui port komunikasi
comm/datamodem/portname	Nama perangkat tempat modem tersambung
gelombang/masuk	Perangkat audio gelombang (hanya input)
gelombang/keluar	Perangkat audio gelombang (hanya output)
gelombang/masuk/keluar	Perangkat audio gelombang, dupleks penuh
midi/in	Pengurut MIDI (hanya input)
midi/out	Pengurut MIDI (hanya output)
tapi/baris	Perangkat garis
tapi/telepon	Perangkat telepon
ndis	Perangkat jaringan
tapi/terminal	Perangkat terminal

 

Nama-nama ini tidak peka huruf besar/kecil, sehingga Anda dapat menggunakan kombinasi huruf besar dan huruf kecil apa pun.

Kelas perangkat tambahan dan nama kelas perangkat mungkin tersedia pada sistem tertentu. Secara umum, jika perangkat bukan milik salah satu kelas perangkat default, produsen biasanya mendefinisikan kelas perangkat baru dan menetapkan nama kelas perangkat yang unik. Anda harus memeriksa dokumentasi perangkat untuk menentukan kelas perangkat tambahan apa yang tersedia untuknya. Namun, perhatikan bahwa meskipun kelas perangkat dan jenis media terkait, mereka tidak sama. Jenis media menjelaskan format informasi tentang panggilan, dan kelas perangkat menentukan antarmuka pemrograman yang digunakan untuk mengelola informasi tersebut. Jadi, bahkan jika produsen mendefinisikan jenis media baru, mungkin tidak benar bahwa produsen juga harus menentukan kelas perangkat baru untuk mendukung mode.

Format data konfigurasi yang digunakan dengan fungsi lineSetDevConfig dan lineGetDevConfig juga bergantung pada kelas perangkat. Secara umum, Anda menggunakan lineGetDevConfig untuk menyimpan salinan data konfigurasi perangkat saat ini dan kemudian menggunakan lineSetDevConfig dengan data konfigurasi yang disimpan untuk memulihkan konfigurasi perangkat ke status sebelumnya. Ini adalah cara mudah untuk mengubah konfigurasi untuk sementara waktu tanpa mengharuskan pengguna memulihkannya secara manual ke status sebelumnya. Karena format data konfigurasi perangkat yang tepat mungkin berbeda dengan setiap penyedia layanan, jangan gunakan lineSetDevConfig dan lineGetDevConfig untuk memanipulasi data konfigurasi perangkat secara langsung. Beberapa format disediakan hanya untuk informasi.