Başlatma ve Kapatma

Bir uygulamanın TAPI'nin 30 ek telefon işlevinden herhangi birini kullanabilmesi için, ileti alabildiği TAPI bağlantısına ihtiyacı vardır. Uygulama, phoneInitializeEx işlevini kullanarak bu bağlantıyı kurar. Bu işlevde uygulama, TAPI'nin uygulamayı telefonun durumundaki değişiklikleri ve telefon işlevlerinin zaman uyumsuz tamamlanmasını bildiren bildirim mekanizmasını belirtir.

phoneInitializeEx işlevi uygulamaya iki bilgi parçası döndürür: uygulamatanıtıcısı ve telefon cihazlarının sayısı. Uygulama tanıtıcısı, uygulamanın TAPI kullanımını temsil eder. Telefon tutamaçlarını kullanan TAPI işlevleri, belirtilen telefon tutamacından türetildiğinden uygulama tutamacını gerektirmez.

phoneInitializeEx tarafından döndürülen ikinci bilgi parçası, TAPI için kullanılabilen telefon cihazlarının sayısıdır. Telefon cihazları, cihaz tanımlayıcılarıyla (cihaz kimliği) tanımlanır. Geçerli cihaz tanımlayıcıları sıfırdan telefon cihazı sayısı eksi bire kadar değişir. Örneğin, phoneInitializeEx sistemde iki telefon cihazı olduğunu bildirirse, geçerli telefon cihazı tanımlayıcıları 0 ve 1'tir. Bir uygulama TAPI'nin telefon işlevlerini kullanmayı bitirdikten sonra, TAPI kullanımını kapatmak için uygulama tutamacını geçirerek phoneShutdownçağırır. Bu, TAPI'nin uygulamaya atanan tüm kaynakları serbest yapmasına olanak tanır.

Uygulamalar daha sonra bir telefon açmadan phoneInitializeEx çağırmamalıdır (en azından izleme için). Uygulama izlenmiyorsa ve hiçbir cihaz kullanmıyorsa, TAPI dinamik bağlantı kitaplığı tarafından ayrılan bellek kaynaklarının gereksizse serbest bırakılabilmesi ve kitaplığın gerekmediğinde bellekten kaldırılabilmesi için phoneShutdown çağırmalıdır.

Hem phoneInitializeEx hem de phoneShutdown zaman uyumlu bir şekilde çalışır. Başka bir ifadeyle, bu işlevler bir başarı veya başarısızlık göstergesi döndürür ve hiçbir zaman zaman uyumsuz istek tanımlayıcısı döndürmez.