TAPI-Geräteklassen
Eine Geräteklasse ist eine Gruppe verwandter physischer Geräte oder Gerätetreiber, über die Anwendungen die Informationen oder Daten senden und empfangen, die einen Anruf tätigen. Jede Geräteklasse verfügt über einen Geräteklassennamen, 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 Telefonieanwendungsprogrammierschnittstelle (TAPI) ordnet Geräte von einer oder mehreren Geräteklassen zu jedem Leitungs- oder Telefongerät zu. Sie greifen auf eines dieser Geräte zu, indem Sie die Geräte-ID für das Gerät mithilfe der lineGetID- oder phoneGetID- funktion abrufen. Sie geben den Namen der Geräteklasse an, und die Funktion gibt den spezifischen Portnamen, den Gerätenamen, das Gerätehandle 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 den nachfolgenden Themen dieses Abschnitts beschrieben.
Außerdem verwenden Sie Geräteklassennamen mit den lineConfigDialog- und phoneConfigDialog- Funktionen, 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 der lineGetDevConfig und lineSetDevConfig Funktionen, um direkt abzurufen und festzulegen Konfigurationsoptionen für das angegebene Gerät.
In der folgenden Liste sind Geräteklassennamen aufgeführt.
Geräteklassenname | Beschreibung |
---|---|
comm | Kommunikationsport. |
comm/datamodem | Modem über einen Kommunikationsport. |
comm/datamodem/portname | Name des Geräts, mit dem ein Modem verbunden ist. |
Welle/in | Wave-Audiogerät (nur Eingabe). |
wellen-/out- | Wave audio device (only output). |
Wellen-/Ein-/Aus- | 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. |
Anmerkung
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 dafür verfügbar sind. Beachten Sie jedoch, dass die Geräteklasse und der Medientyp zwar miteinander verknüpft sind, sie jedoch nicht identisch sind. Ein Medientyp beschreibt das Anrufinformationsformat, und eine Geräteklasse definiert die Programmierschnittstelle, die zum Verwalten dieser Informationen verwendet wird. Selbst wenn ein Hersteller einen neuen Medientyp definiert, muss der Hersteller auch eine neue Geräteklasse definieren, um den Modus zu unterstützen.
Das Format der konfigurationsdaten, die mit der lineSetDevConfig und lineGetDevConfig--Funktionen 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 in den vorherigen Zustand wiederherzustellen. Dies ist eine bequeme Möglichkeit, die Konfiguration vorübergehend zu ändern, ohne dass der Benutzer sie manuell im vorherigen Zustand wiederherstellen muss. Da das genaue Format der Gerätekonfigurationsdaten bei jedem Dienstanbieter unterschiedlich sein kann, sollten Sie nicht lineSetDevConfig- und lineGetDevConfig- verwenden, um die Gerätekonfigurationsdaten direkt zu bearbeiten. Einige Formate werden nur für Informationen bereitgestellt.