TAPI-Geräteklassen

Eine Geräteklasse ist eine Gruppe verwandter physischer Geräte oder Gerätetreiber, über die Anwendungen die Informationen oder Daten, aus denen ein Anruf besteht, senden und empfangen. Jede Geräteklasse verfügt über einen Geräteklassennamen , der die Klasse eindeutig identifiziert und Informationen zur Programmierschnittstelle und zu Den Befehlen bereitstellt, die zum Öffnen und Kommunizieren mit den Geräten in der Klasse verwendet werden können.

Die Telefonieanwendungsprogrammierschnittstelle (TAPI) ordnet jedem Leitungs- oder Telefongerät Geräte aus einer oder mehreren Geräteklassen zu. Sie greifen auf eines dieser Geräte zu, indem Sie den Gerätebezeichner für das Gerät mithilfe der Funktion lineGetID oder phoneGetID abrufen. Sie geben den Geräteklassennamen an, und die Funktion gibt den spezifischen Portnamen, Gerätenamen, Gerätehandle oder Gerätebezeichner zurück, die Sie zum Öffnen und Zugreifen auf das Gerät benötigen. Das Format der zurückgegebenen Informationen hängt von der Geräteklasse ab und wird in den folgenden Themen dieses Abschnitts beschrieben.

Sie verwenden auch Geräteklassennamen mit den Funktionen lineConfigDialog und phoneConfigDialog , um es dem Benutzer zu ermöglichen, Konfigurationsoptionen für das angegebene Gerät festzulegen, mit den Funktionen lineGetIcon und phoneGetIcon , um ein Symbol abzurufen, um das angegebene Gerät darzustellen, und mit den Funktionen lineGetDevConfig und lineSetDevConfig zum direkten Abrufen und Festlegen von Konfigurationsoptionen für das angegebene Gerät.

Die folgende Liste enthält Geräteklassennamen.

Geräteklassenname	Beschreibung
comm	Kommunikationsport.
comm/datamodem	Modem über einen Kommunikationsport.
comm/datamodem/portname	Name des Geräts, mit dem ein Modem verbunden ist.
wave/in	Wave-Audiogerät (nur Eingabe).
wave/out	Wave-Audiogerät (nur Ausgabe).
wave/in/out	Wave-Audiogerät, Vollduplex.
midi/in	MIDI-Sequenzer (nur Eingabe).
midi/out	MIDI-Sequenzer (nur Ausgabe).
tapi/line	Leitungsgerät.
tapi/phone	Telefongerät.
Ndis	Netzwerkgerät.
tapi/terminal	Terminalgerät.

 

Hinweis

Bei diesen Namen wird die Groß-/Kleinschreibung nicht beachtet. 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 nicht zu einer der Standardgeräteklassen gehört, definiert der Hersteller in der Regel eine neue Geräteklasse und weist einen eindeutigen Geräteklassennamen zu. Überprüfen Sie die Dokumentation für das Gerät, um zu ermitteln, welche zusätzlichen Geräteklassen für das Gerät verfügbar sind. Beachten Sie jedoch, dass die Geräteklasse und der Medientyp zwar miteinander zusammenhängen, aber nicht identisch sind. Ein Medientyp beschreibt das Aufrufinformationsformat, und eine Geräteklasse definiert die Programmierschnittstelle, die zum Verwalten dieser Informationen verwendet wird. Selbst wenn ein Hersteller also einen neuen Medientyp definiert, ist es nicht unbedingt richtig, 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 verwenden Sie später lineSetDevConfig mit den gespeicherten Konfigurationsdaten, um die Gerätekonfiguration im vorherigen Zustand wiederherzustellen. Dies ist eine bequeme Möglichkeit, die Konfiguration vorübergehend zu ändern, ohne dass der Benutzer sie manuell in den vorherigen Zustand wiederherstellen muss. Da das genaue Format der Gerätekonfigurationsdaten bei jedem Dienstanbieter unterschiedlich sein kann, sollten Sie lineSetDevConfig und lineGetDevConfig nicht verwenden, um die Gerätekonfigurationsdaten direkt zu bearbeiten. Einige Formate werden nur zu Informationszwecken bereitgestellt.