Initialisatie en afsluiten

Voor een toepassing om een van de 30 aanvullende telefoonfuncties van TAPI te kunnen gebruiken, heeft deze een verbinding met TAPI nodig, waarmee hij berichten kan ontvangen. De toepassing brengt deze verbinding tot stand met behulp van de functie phoneInitializeEx. In deze functie geeft de toepassing het meldingsmechanisme op waarmee TAPI de toepassing informeert van wijzigingen in de status van de telefoon en van asynchrone voltooiing van telefoonfuncties.

De functie phoneInitializeEx retourneert twee stukjes informatie naar de toepassing: een toepassing verwerkten het aantal telefoonapparaten. De toepassingsgreep vertegenwoordigt het gebruik van TAPI van de toepassing. Voor de TAPI-functies die gebruikmaken van telefoongrepen is de toepassingsgreep niet vereist, omdat deze ingang is afgeleid van de opgegeven telefoongreep.

Het tweede stukje informatie dat wordt geretourneerd door phoneInitializeEx is het aantal telefoonapparaten dat beschikbaar is voor TAPI. Telefoonapparaten worden geïdentificeerd door hun apparaat-id (apparaat-id). Geldige apparaat-id's variëren van nul tot het aantal telefoonapparaten min één. Als phoneInitializeEx bijvoorbeeld rapporteert dat er twee telefoonapparaten in een systeem zijn, zijn geldige telefoonapparaat-id's 0 en 1. Nadat een toepassing is voltooid met de telefoonfuncties van TAPI, roept deze phoneShutdown-aan, waarbij de toepassingsgreep wordt doorgegeven om het gebruik van TAPI af te sluiten. Hierdoor kan TAPI alle resources die zijn toegewezen aan de toepassing vrij maken.

Toepassingen mogen phoneInitializeEx niet aanroepen zonder vervolgens een telefoon te openen (ten minste voor bewaking). Als de toepassing niet controleert en geen apparaten gebruikt, moet deze phoneShutdown- aanroepen, zodat geheugenbronnen die zijn toegewezen door de TAPI dynamic-link-bibliotheek kunnen worden vrijgegeven als dit niet nodig is en de bibliotheek zelf uit het geheugen kan worden verwijderd terwijl deze niet nodig is.

Zowel phoneInitializeEx als phoneShutdown synchroon werken. Dat wil gezegd: deze functies retourneren een geslaagde of foutindicatie en retourneren nooit een asynchrone aanvraag-id.