Wersjonowanie TAPI

Z czasem mogą być tworzone różne wersje interfejsu TAPI, aplikacji i dostawców usług. Te nowe wersje mogą tworzyć nowe definicje, takie jak nowe funkcje, nowe elementy członkowskie w strukturach danych i nowe pola bitowe. W związku z tym numery wersji są niezbędne do wskazania, jak interpretować różne struktury danych.

Aby umożliwić optymalne współdziałanie różnych wersji aplikacji, wersji TAPI oraz wersji usług dostawców różnych firm, Microsoft Telephony oferuje prosty mechanizm negocjacji wersji dla aplikacji. Istnieją dwie różne wersje, które interfejs TAPI i dostawca usług telefonii muszą uzgodnić dla każdego urządzenia liniowego. Pierwsza to wersja negocjowana z TAPI oraz dostawcą usług telefonii (TSP) w zakresie telefonii podstawowej i dodatkowej, nazywana wersją interfejsu TAPI. Druga dotyczy rozszerzeń specyficznych dla dostawcy, jeśli istnieją, i jest nazywana wersją rozszerzenia. Format struktur danych i typów danych używanych przez funkcje podstawowe i dodatkowe interfejsu TAPI jest definiowany przez wersję interfejsu TAPI, podczas gdy wersja rozszerzenia określa format struktur danych zdefiniowanych przez rozszerzenia specyficzne dla dostawcy.

Funkcja lineNegotiateAPIVersion negocjuje wersję interfejsu TAPI i lineNegotiateExtVersion negocjuje wersję rozszerzenia TSP. Pojedynczy TSP może obsługiwać więcej niż jedną wersję, a aplikacja musi "wrócić" do korzystania ze starszej wersji, jeśli korzysta ze starszego dostawcy TSP. W lineNegotiateAPIVersion parametr dwApiVersion domyślnie przyjmuje wartość zgodnie z wersją.

Jednak interfejs TAPI sprawia, że jest to znacznie łatwiejsze, o ile sam TSP używa nowszej wersji niż aplikacja. Jeśli TSP jest rzeczywiście nowszy, interfejs TAPI może dostosować się do wersji aplikacji. Na przykład, TSP-y TAPI 2.0 nie muszą być specjalnie zdolne do obsługi TAPI w wersji 1.4. Jeśli aplikacja TAPI 1.4 jest uruchomiona, interfejs TAPI konwertuje wszystkie struktury i komunikaty TAPI 2.0 na odpowiedniki TAPI 1.4 lub jak najbliżej. Jeśli w interfejsie TAPI 1.4 nie ma bliskiego przybliżenia, wszystkie informacje specyficzne dla interfejsu TAPI 2.0 zostaną utracone.

Dokładne znaczenie wersji rozszerzenia jest specyficzne dla dostawcy. Aby użyć dostawcy TSP obsługującego rozszerzenia, zapoznaj się z dokumentacją dostawcy.

Istnieje wiele wersji interfejsu TAPI. Podczas gdy większość tych wersji dotyczyła zmian w zestawach dokumentacji interfejsu TAPI i interfejsu dostawcy usług telefonii (TSPI), istnieją inne konsekwencje dla każdej wersji, a mianowicie różnice architektury, odmiany systemu operacyjnego, pakiety redystrybucyjne i problemy z programowaniem TSP.