Inisialisasi dan Matikan

Agar aplikasi dapat menggunakan salah satu dari 30 fungsi telepon tambahan TAPI, aplikasi memerlukan koneksi ke TAPI, di mana aplikasi dapat menerima pesan. Aplikasi membuat koneksi ini menggunakan fungsiphoneInitializeEx. Dalam fungsi ini, aplikasi menentukan mekanisme pemberitahuan di mana TAPI menginformasikan penerapan perubahan status telepon dan penyelesaian asinkron fungsi telepon.

FungsiphoneInitializeExmengembalikan dua informasi ke aplikasi: handel aplikasi , dan jumlah perangkat telepon. Handel aplikasi mewakili penggunaan TAPI aplikasi. Fungsi TAPI yang menggunakan handel telepon tidak memerlukan handel aplikasi, karena handel ini berasal dari handel telepon yang ditentukan.

Bagian kedua dari informasi yang dikembalikan oleh phoneInitializeEx adalah jumlah perangkat telepon yang tersedia untuk TAPI. Perangkat telepon diidentifikasi oleh pengidentifikasi perangkat mereka (ID perangkat). Pengidentifikasi perangkat yang valid berkisar dari nol hingga jumlah perangkat telepon dikurangi satu. Misalnya, jika phoneInitializeEx melaporkan bahwa ada dua perangkat telepon dalam sistem, pengidentifikasi perangkat telepon yang valid adalah 0 dan 1. Setelah aplikasi selesai menggunakan fungsi telepon TAPI, aplikasi memanggil phoneShutdown, meneruskan handel aplikasinya untuk mematikan penggunaan TAPI. Ini memungkinkan TAPI untuk membebaskan sumber daya apa pun yang ditetapkan ke aplikasi.

Aplikasi tidak boleh memanggil phoneInitializeEx tanpa kemudian membuka telepon (setidaknya untuk pemantauan). Jika aplikasi tidak memantau dan tidak menggunakan perangkat apa pun, aplikasi harus memanggil phoneShutdown sehingga sumber daya memori yang dialokasikan oleh pustaka tautan dinamis TAPI dapat dirilis jika tidak diperlukan, dan pustaka itu sendiri dapat dibongkar dari memori saat tidak diperlukan.

Baik telepon InitializeEx dan telepon Shutdown beroperasi secara sinkron. Artinya, fungsi-fungsi ini mengembalikan indikasi keberhasilan atau kegagalan, dan tidak pernah mengembalikan pengidentifikasi permintaan asinkron.