Gerätesteuerung (Telefonie-API)
Die Gerätesteuerung auf Endbenutzer- oder Serveranwendungsebene erfordert einen relativ kleinen Satz grundlegender Informationen. Die Dienstanbieter-Abstraktionsebene 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 Transportebene für die Kommunikation. Aus Sicht einer Anwendung werden Informationen über das Netzwerk in der Regel in den Adresstyp eingebettet, z. B. LINEADDRESSTYPE_PHONENUMBER.
- Line: Eine Verbindung mit einem Netzwerk. Dieses Konzept wird in TAPI 2.2 (TAPI/C) stark genutzt.
- Kanal: Eine Unterteilung einer Zeile. Die Kenntnis von Kanälen ist normalerweise für eine Anwendung nicht erforderlich, da der Dienstanbieter konfiguriert, wie sie als Adressen angezeigt werden.
- Adresse: Ein Netzwerkstandort in einem Netzwerk. Jede Zeile oder jeder Kanal verfügt über eine oder mehrere zugeordnete Adressen. Die Adresse ist ein Schlüsselkonzept 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 Gerätemerkmale an TAPI als Reaktion auf Anwendungsabfragen. Dienstanbieter initiieren auch Berichte zu Änderungen des Gerätezustands. Diese Änderungen werden dann basierend auf den während der Initialisierung angeforderten Benachrichtigungen an eine Anwendung gemeldet.
Grundlegende Gerätemerkmale sind:
Darüber hinaus liefern die Diensteanbieter Informationen über die Fähigkeit einer bestimmten Adresse, verschiedene Sitzungsvorgänge durchzuführen.
Zusätzliche Merkmale können bestimmten Geräten zugeordnet werden, wenn die Dienstanbieter sie unterstützen. Eine TAPI 2.x-Anwendung ermittelt Funktionen mithilfe der Funktionen lineGetDevCaps und lineGetAddressCaps . TAPI 3.x-Anwendungen verwenden hierfür die SCHNITTSTELLE ITAddressCapabilities .
TAPI 2.x bietet einen speziellen Satz von zusätzlichen Vorgängen, die der Dienstanbieter für die Verwendung mit Telefongeräten implementieren kann. Weitere Informationen finden Sie unter Telefongeräte.
Erweiterte Funktionen sind anbieterspezifisch und werden nicht direkt von der Microsoft-Telefonie-API abgedeckt. Weitere Informationen finden Sie unter Erweiterte Leitungsfunktionen, erweiterte Telefoniefunktionen oder 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 Leitungsgerät ab, um die Telefoniefunktionen zugeordneter Adressen zu bestimmen. |
lineGetAddressCaps | Fragt ein angegebenes Leitungsgerät ab, um die Telefoniefunktionen einer bestimmten Adresse zu bestimmen. |
lineGetDevConfig | Gibt eine "undurchsichtige" 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 aktuellen status ab, z. B. die Anzahl aktiver Aufrufe. |
lineSetLineDevStatus | Legt das Gerät status fest, z. B. das Festlegen eines Geräts als nicht im Dienst. |
lineGetIcon | Ruft das anbieterspezifische Symbol zur Anzeige für den Benutzer ab. |
lineNegotiateExtVersion | Ermöglicht einer Anwendung das Aushandeln einer Erweiterungsversion, die mit dem angegebenen Leitungsgerä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 das DirectShow-Medienformat™ fest und ruft es ab. |
ITBasicAudioTerminal | Legt standardmäßige Audioterminalmerkmale fest und ruft sie ab, z. B. die Lautstärke. |
ITMediaSupport | Ruft Informationen zu den Medienunterstützungsfunktionen einer Adresse ab. |
ITTerminal | Basisschnittstelle für das Terminal-Objekt. Ruft Informationen wie unterstützte Terminalklassen und Medien ab. |
ITTerminalSupport | Ruft Informationen zu verfügbaren Terminals ab und erstellt zusätzliche Terminals. |
Anbieterspezifische Schnittstellen | Vom Dienstanbieter abhängig. |