TAPI-Befehle
TAPI-Befehle Befehle für die TAPI-Schnittstelle
Befehle
TapiCallTapiCloseTapiConferenceTapiConferenceCommitTapiConferenceDialTapiDialTapiForwardTapiInfoTapiListenTapiOpenTapiPickup
Mit den TAPI-Befehlen können die Funktionen der TAPI-Schnittstelle (Telephony API) benutzt werden. Die TAPI-Schnittstelle teilt sich in zwei Ebenen: Die Schnittstelle des Betriebssystems und die Gerätetreiber ( TapiDevice ).
Mit dem Befehl TapiOpen () wird die Schnittstelle initialisiert und der Deskriptor einer Liste mit Gerätetreibern zurückgegeben. Die Liste der Gerätetreiber und die Gerätetreiber selber können verwendet werden, bis mit dem Befehl TapiClose () die Liste geschlossen wird.
Um eine Nummer zu wählen, wird der Befehl TapiDial () verwendet. Das Format des zu übergebenen Wählstrings hängt im wesentlichen von der Implementation des Gerätetreibers ab. In der Regel sollten hier nur Zeichenketten übergeben werden, die ausschließlich aus Ziffern bestehen.
Sollen eingehende Telefonate erkannt werden, wird der Befehl TapiListen () benötigt. Dem Befehl wird der Deskriptor eines Gerätetreibers und eines Fensters übergeben. Kommt auf dem Gerätetreiber ein Gespräch an, wird das Ereignis EvtTapi des Fensters ausgelöst. Die Überwachung bleibt erhalten, bis sie durch den Befehl TapiListen () wieder deaktiviert wird.
Damit mit einer aktiven Verbindung weitere Aktionen (Vermitteln, Konferenzschaltungen usw.) durchgeführt werden können, werden Besitzrechte an dieser Verbindung benötigt. Diese Besitzrechte werden über die Eigenschaft TapiFlags gesteuert. Standardmäßig werden Besitzrechte angefordert. Sollen Verbindungen über ein TAPI-Gerät nur überwacht werden (Monitoring), muss das Flag _TapiListenMonitor eingetragen werden. Das nächsten TapiListen () wird dann ohne Besitzrechte an den Verbindungen durchgeführt.
Folgende Befehle können nicht auf eine CallID durchgeführt werden, für die keine Besitzrechte vorhanden sind:
TapiCall ()mit_TapiCallOpAnswer,_TapiCallOpDropoder_TapiCallOpHoldTapiForward ()TapiConference (),TapiConferenceDial (),TapiConferenceCommit ()
In einem solchen Fall geben die Funktionen den Fehlerwert _ErrTapiNotOwner zurück.
Die TAPI-Schnittstelle muss mindestens die Version 2.0 und der Gerätetreiber die Version 1.4 besitzen, um von CONZEPT 16 angesprochen zu werden. Die TAPI-Version des Gerätetreibers kann über die Systemeigenschaft Version des Gerätetreibers ermittelt werden.