TSPI-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 diesem Abschnitt beschrieben.

Sie verwenden auch Geräteklassennamen mit den Funktionen lineConfigDialog und phoneConfigDialog , damit der Benutzer Konfigurationsoptionen für das angegebene Gerät festlegen kann. mit den Funktionen lineGetIcon und phoneGetIcon , um ein Symbol abzurufen, das das angegebene Gerät darstellt; und mit den Funktionen lineGetDevConfig und lineSetDevConfig zum direkten Abrufen und Festlegen von Konfigurationsoptionen für das angegebene Gerät.

Im Folgenden sind die Standardgeräteklassennamen aufgeführt.

Bei diesen Namen wird die Groß-/Kleinschreibung nicht beachtet, sodass Sie eine beliebige Kombination aus Groß- und Kleinbuchstaben verwenden können.

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. Sie müssen die Dokumentation für das Gerät überprüfen, 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 ein Format von Informationen zu einem Aufruf, und eine Geräteklasse definiert die Programmierschnittstelle, die zum Verwalten dieser Informationen verwendet wird. Selbst wenn ein Hersteller einen neuen Medientyp definiert, stimmt es möglicherweise nicht, 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, verwenden Sie nicht lineSetDevConfig und lineGetDevConfig , um die Gerätekonfigurationsdaten direkt zu bearbeiten. Einige Formate werden nur zu Informationszwecken bereitgestellt.