TAPI-Geräteklassen

Eine Geräteklasse ist eine Gruppe von verwandten physischen Geräten oder Gerätetreibern, über die Anwendungen informationen oder Daten senden und empfangen, die einen Anruf bilden. Jede Geräteklasse verfügt über einen Geräteklassenamen , der die Klasse eindeutig identifiziert und Informationen über die Programmierschnittstelle und Befehle bereitstellt, die zum Öffnen und Kommunizieren mit den Geräten in der Klasse verwendet werden können.

Die Telefonieanwendungsprogrammierungsschnittstelle (TAPI) verknüpft Geräte von einer oder mehreren Geräteklassen zu jedem Telefongerät. Sie greifen auf eine dieser Geräte zu, indem Sie den Gerätebezeichner für das Gerät mithilfe der Funktion "lineGetID " oder "phoneGetID " abrufen. Sie geben den Namen der Geräteklasse an, und die Funktion gibt den spezifischen Portnamen, den Gerätenamen, den Gerätehandpunkt oder den Gerätebezeichner zurück, den Sie öffnen und auf das Gerät zugreifen müssen. Das Format der zurückgegebenen Informationen hängt von der Geräteklasse ab und wird in nachfolgenden Themen dieses Abschnitts beschrieben.

Sie verwenden auch Geräteklassennamen mit den Funktionen "lineConfigDialog" und "phoneConfigDialog", damit der Benutzer Konfigurationsoptionen für das angegebene Gerät festlegen kann, wobei die Funktionen lineGetIcon und phoneGetIcon ein Symbol abrufen, um das angegebene Gerät darzustellen, und mit den Funktionen lineGetDevConfig und lineSetDevConfig direkt Konfigurationsoptionen für das angegebene Gerät abzurufen und festzulegen.

Die folgende Liste zeigt Geräteklassennamen.

Name der Geräteklasse BESCHREIBUNG
comm Kommunikationsport.
comm/datamodem Modem über einen Kommunikationsport.
comm/datamodem/portname Name des Geräts, mit dem ein Modem verbunden ist.
Wellen/In Wave Audio-Gerät (nur Eingabe).
Welle/Out Wave Audiogerät (nur Ausgabe).
wave/in/out Wave Audio device, full duplex.
midi/in MIDI-Sequenzer (nur Eingabe).
midi/out MIDI-Sequenzer (nur Ausgabe).
tapi/line Line-Gerät.
tapi/phone Telefon Gerät.
Ndis Netzwerkgerät.
tapi/terminal Terminalgerät.

 

Hinweis

Diese Namen sind nicht groß- und kleinschreibungsempfindlich; Sie können eine beliebige Kombination aus Groß- und Kleinbuchstaben verwenden.

 

Zusätzliche Geräteklassen und Geräteklassennamen sind möglicherweise auf einem bestimmten System verfügbar. Wenn ein Gerät im Allgemeinen nicht zu einer der Standardgeräteklassen gehört, definiert der Hersteller in der Regel eine neue Geräteklasse und weist einen eindeutigen Geräteklassenamen zu. Überprüfen Sie die Dokumentation für das Gerät, um zu ermitteln, welche zusätzlichen Geräteklassen für sie verfügbar sind. Beachten Sie jedoch, dass die Geräteklasse und der Medientyp verknüpft sind, sie sind jedoch nicht identisch. Ein Medientyp beschreibt das Anrufinformationsformat, und eine Geräteklasse definiert die Programmierschnittstelle, die zum Verwalten dieser Informationen verwendet wird. Auch wenn ein Hersteller einen neuen Medientyp definiert, ist es nicht unbedingt wahr, dass der Hersteller auch eine neue Geräteklasse definieren muss, um den Modus zu unterstützen.

Das Format der konfigurationsdaten, die mit den Funktionen lineSetDevConfig und lineGetDevConfig verwendet werden, hängt auch von der Geräteklasse ab. Im Allgemeinen verwenden Sie lineGetDevConfig , um eine Kopie der aktuellen Gerätekonfigurationsdaten zu speichern und dann später lineSetDevConfig mit den gespeicherten Konfigurationsdaten zum Wiederherstellen der Gerätekonfiguration in den vorherigen Zustand zu verwenden. Dies ist eine bequeme Möglichkeit, die Konfiguration vorübergehend zu ändern, ohne dass der Benutzer es manuell in den vorherigen Zustand wiederherstellen muss. Da das genaue Format der Gerätekonfigurationsdaten möglicherweise mit jedem Dienstanbieter unterschiedlich ist, sollten Sie lineSetDevConfig und lineGetDevConfig nicht verwenden, um die Gerätekonfigurationsdaten direkt zu bearbeiten. Einige Formate werden nur für Informationen bereitgestellt.