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.