Terminalobject

In TAPI versie 3.0 en hoger gebruikt het TAPI-objectmodel terminalobjecten om de bron of sink van een mediastroom weer te geven die is gekoppeld aan een oproep- of communicatiesessie. Met dit objectmodel kan een toepassing op gedetailleerd niveau opgeven hoe media worden verwerkt in een aanroep. Met dit model kunnen ook meerdere terminals tegelijk worden geselecteerd, zodat een oproep bijvoorbeeld kan worden uitgevoerd naar een audiospreker en tegelijkertijd kan worden opgenomen.

Het Terminal-object vertegenwoordigt een bron of renderer, zoals een microfoon of luidspreker. Een toepassing kiest uit beschikbare terminals op basis van de mediarichting en het type of de typen die betrokken zijn bij een communicatiesessie. Elke gekoppelde mediastroom wordt vervolgens geselecteerd op de juiste terminal om te beginnen met streamen.

Terminals worden normaal gesproken geïmplementeerd door een mediaserviceprovider (MSP) en terminalobjecten zijn niet beschikbaar als er geen MSP is gekoppeld aan een communicatiesessie. Een uitzondering hierop is dat een toepassing met Windows 2000 SP1 en hoger een vorm van pluggable terminalkan implementeren. Hierdoor kan een conferentieserver overbruggingsterminals maken, zodat niet-Windows 2000 SP1- of niet-multicast H323-clients kunnen worden toegevoegd aan TAPI 3 multi-party SDP/IP multicast-conferenties.

Elke terminal behoort tot een terminalklasse. Een terminalklasse vertegenwoordigt een set bron- of renderfuncties. Een terminal die wordt toegewezen aan een set audioluidsprekers, wordt bijvoorbeeld geïdentificeerd als CLSID_SpeakersTerminal en de serviceprovider zou naar verwachting volumeregeling moeten implementeren. TAPI 3 definieert een set terminalklassen, een MSP kan extra klassen definiëren en een toepassing kan nieuwe terminalklassen registreren. Aan elke terminalklasse wordt een GUID (Globally Unique Identifier) toegewezen.

Vanuit het oogpunt van een toepassing wordt een terminal beschreven door het terminaltype en richting. Het type kan statisch of dynamisch zijn. Een statische terminal wordt toegewezen aan hardware, zoals een telefoon of microfoon. Een dynamische terminal wordt toegewezen aan een tijdelijk object, zoals een bestand of een videovenster. In de richting wordt beschreven of een bepaalde terminal een bron of een renderer is.

De mogelijkheden van een bepaald terminalobject kunnen aanzienlijk variëren, afhankelijk van het huidige serviceproviderpaar dat in gebruik is. De MSP voor een gespecialiseerd apparaat kan een interface implementeren met methoden die geschikt zijn voor dat apparaat. Deze interface kan worden samengevoegd naar het terminalobject en de methoden die beschikbaar worden gesteld voor een toepassing. Zie de documentatie van de mediaserviceprovider voor meer informatie en referentiemateriaal.

Zie Terminal Object Interfacesvoor meer informatie over terminalinterfaces en methoden die zijn geïmplementeerd door TAPI 3.

Als de auteurs van een mediaserviceprovider de MSP-basisklassen gebruiken, kunnen ze enkele van de mediastreamingterminalfuncties implementeren.

Zie Een oproep maken en Een oproep ontvangenvoor meer informatie en codevoorbeelden waarin illustraties van het gebruik van een Terminal-object worden weergegeven.

Windows XP: Zie File terminals, Multitrack terminalsen Pluggable terminalsvoor meer informatie over hoe het Terminal-object is uitgebreid in Windows XP.

Zie voor meer informatie en codevoorbeelden File Terminalsgebruiken, Multitrack Terminals gebruiken en het standaardselectiemechanismeen Pluggable Terminal Registration.