Gerätesteuerung (Telefonie-API)
Die Gerätesteuerung auf Endbenutzer- oder Serveranwendungsebene erfordert einen relativ kleinen Satz grundlegender Informationen. Die Abstraktionsschicht des Dienstanbieters führt eine detaillierte Gerätesteuerung durch. Die Dienstanbieter melden erforderliche Geräteinformationen über TAPI an eine Anwendung.
Zu den wichtigsten Gerätekategorien gehören:
- Netzwerk:Die Transportschicht für die Kommunikation. Aus Sicht einer Anwendung werden Informationen über das Netzwerk in der Regel in den Adresstyp eingebettet, z. B. LINEADDRESSTYPE _ PHONENUMBER.
- Zeile:Eine Verbindung mit einem Netzwerk. Dieses Konzept wird in TAPI 2.2 (TAPI/C) stark verwendet.
- Channel:Eine Untereinheit einer Zeile. Die Kenntnis von Kanälen ist für eine Anwendung normalerweise nicht erforderlich, da der Dienstanbieter konfiguriert, wie sie als Adressen angezeigt werden.
- Adresse:Eine Netzwerkadresse in einem Netzwerk. Jeder Zeile oder jedem Kanal ist mindestens eine Adresse zugeordnet. Die Adresse ist ein wichtiges Konzept sowohl in TAPI 3.1 (TAPI/COM) als auch in TAPI 2.2 (TAPI/C).
- Terminal:Eine Quelle oder ein Renderer für eine bestimmte Adresse und einen bestimmten Medientyp.
Die Dienstanbieter melden TAPI gerätemerkmale als Reaktion auf Anwendungsabfragen. Dienstanbieter initiieren auch Berichte zu Änderungen im Gerätezustand. Diese Änderungen werden dann basierend auf den während der Initialisierung angeforderten Benachrichtigungen an eine Anwendung gemeldet.
Grundlegende Gerätemerkmale sind:
Darüber hinaus stellen die Dienstanbieter Informationen zur Kapazität einer bestimmten Adresse bereit, um verschiedene Sitzungsvorgänge auszuführen.
Zusätzliche Merkmale können bestimmten Geräten zugeordnet werden, wenn sie von den Dienstanbietern unterstützt werden. Eine TAPI 2.x-Anwendung ermittelt Funktionen mithilfe der Funktionen lineGetDevCaps und lineGetAddressCaps. TAPI 3.x-Anwendungen verwenden zu diesem Zweck die ITAddressCapabilities-Schnittstelle.
TAPI 2.x bietet eine spezielle Reihe von zusätzlichen Vorgängen, die der Dienstanbieter für die Verwendung mit Telefongeräten implementieren kann. Weitere Informationen finden Sie unter Telefon Devices.
Erweiterte Funktionen sind anbieterspezifisch und werden nicht direkt von der Microsoft-Telefonie-API abgedeckt. Weitere Informationen finden Sie unter Funktionen für erweiterte Linien, erweiterte Telefonie Telefon Funktionenoder anbieterspezifische Schnittstellen.
Im Folgenden finden Sie eine Zusammenfassung der TAPI-Vorgänge, die Dienstanbieter nach Gerätemerkmalen abfragen und Daten zum aktuellen Zustand bereitstellen.
| TAPI 2.x-Funktionen | Beschreibung |
|---|---|
| lineGetDevCaps | Fragt ein angegebenes Liniengerät ab, um die Telefoniefunktionen der zugeordneten Adressen zu bestimmen. |
| lineGetAddressCaps | Fragt ein angegebenes Liniengerät ab, um die Telefoniefunktionen einer bestimmten Adresse zu bestimmen. |
| lineGetDevConfig | Gibt eine "nicht transparente" Datenstruktur zurück, in der die aktuelle Konfiguration eines Geräts gespeichert wird. |
| lineSetDevConfig | Stellt die Gerätekonfiguration wieder her. |
| lineConfigDialog | Zeigt ein Dialogfeld an, in dem der Benutzer Parameter konfigurieren kann, die sich auf das Gerät beziehen. |
| lineGetID | Ruft einen stabilen Gerätebezeichner ab, der in weiteren TAPI-Funktionsaufrufen oder mit einer anderen API verwendet werden kann. |
| lineGetLineDevStatus | Fragt das Gerät nach dem aktuellen Status ab, z. B. nach der Anzahl aktiver Aufrufe. |
| lineSetLineDevStatus | Legt den Gerätestatus fest, z. B. das Festlegen eines Geräts als nicht im Dienst. |
| lineGetIcon | Ruft ein anbieterspezifisches Symbol für die Anzeige für den Benutzer ab. |
| lineNegotiateExtVersion | Ermöglicht es einer Anwendung, eine Erweiterungsversion auszuhandeln, die mit dem angegebenen Zeilengerät verwendet werden soll. |
| lineDevSpecific | Gewährt Zugriff auf gerätespezifische Features. |
| lineDevSpecificFeature | Sendet gerätespezifische Features an den Dienstanbieter. |
| TAPI 3.x-Schnittstellen oder -Methoden | Beschreibung |
|---|---|
| ITAddressCapabilities | Ruft Informationen zu den Funktionen einer Adresse ab. |
| ITAMMediaFormat | Legt directShow™ Medienformat fest und ruft es ab. |
| ITBasicAudioTerminal | Legt Standardmerkmale des Audioterminals fest, z. B. Lautstärke, und ruft diese ab. |
| ITMediaSupport | Ruft Informationen zu den Medienunterstützungsfunktionen einer Adresse ab. |
| ITTerminal | Basisschnittstelle für das Terminalobjekt. Ruft Informationen wie Terminalklasse und unterstützte Medien ab. |
| ITTerminalSupport | Ruft Informationen zu verfügbaren Terminals ab und erstellt zusätzliche Terminals. |
| Anbieterspezifische Schnittstellen | Dienstanbieterabhängig. |