TAPI-versionshantering

Med tiden kan olika versioner av TAPI, program och tjänsteleverantörer produceras. Dessa nya versioner kan skapa nya definitioner, till exempel för nya funktioner, nya medlemmar i datastrukturer och nya bitfält. Versionsnummer är därför nödvändiga för att ange hur olika datastrukturer ska tolkas.

Microsoft Telephony tillhandahåller en enkel förhandlingsmekanism för program för att möjliggöra optimal samverkan mellan olika versioner av program, versioner av TAPI och versioner av tjänsteleverantörer av olika leverantörer. Det finns två olika versioner som TAPI och telefonitjänstleverantören måste komma överens om för varje radenhet. Den första är den version som förhandlats fram med TAPI och TSP (TelePhony Service Provider) Basic och Supplement Telephony, som kallas TAPI-gränssnittsversionen. Det andra gäller eventuella providerspecifika tillägg och kallas för tilläggsversionen. Formatet för de datastrukturer och datatyper som används av TAPI:s grundläggande och kompletterande funktioner definieras av TAPI-versionen, medan tilläggsversionen bestämmer formatet för datastrukturer som definieras av de leverantörsspecifika tilläggen.

Funktionen lineNegotiateAPIVersion förhandlar om en TAPI-version och lineNegotiateExtVersion förhandlar om TSP-tilläggsversionen. En enskild TSP kan hantera mer än en version och ett program måste "falla tillbaka" till att använda en äldre version om du använder en äldre TSP. I lineNegotiateAPIVersion är parameter dwApiVersion standardmässigt inställt på ett värde beroende på version, enligt följande.

TAPI-version	Standardvärde
1.3	0x00010003
1.4	0x00010004
2.0	0x00020000
2.1	0x00020001
2.2	0x00020002

 

TAPI gör dock detta mycket enklare så länge TSP:n själv använder en nyare version än programmet. Om TSP verkligen är nyare kan TAPI anpassa sig till applikationens version. TSP:er för TAPI 2.0 behöver till exempel inte vara särskilt kapabla att hantera TAPI-version 1.4. Om ett TAPI 1.4-program körs konverterar TAPI alla TAPI 2.0-strukturer och meddelanden till TAPI 1.4-motsvarigheter eller så nära som möjligt. Om det inte finns någon nära uppskattning i TAPI 1.4 går all TAPI 2.0-specifik information förlorad.

Den exakta innebörden av en tilläggsversion är providerspecifik. Om du vill använda en TSP som stöder tillägg läser du leverantörens dokumentation.

Det finns ett antal versioner av TAPI. De flesta av dessa versioner omfattade ändringar i TSPI-dokumentationsuppsättningarna (TAPI och Telephony Service Provider Interface), men det finns andra konsekvenser för varje version, nämligen arkitekturskillnader, operativsystemvariationer, omdistribuerbara objekt och TSP-utvecklingsproblem.

TAPI-version	Fördelning
1.0 – 1.2	Betaversioner som inte ska användas längre.
1,4	Ingår i Windows 95.
1,5	Ingår i Windows CE 1.0.
2.0	Ingår i Windows NT 4.0 med SP3.
2.1	Ingår i Windows NT 4.0 med SP4 och Windows 98.
2.2	Ingår i Windows Server 2003, Windows XP och Windows 2000.