lineGetDevConfig-Funktion (tapi.h)
Die lineGetDevConfig-Funktion gibt ein "undurchsichtiges" Datenstrukturobjekt zurück, dessen Inhalt für die Zeile (Dienstanbieter) und die Geräteklasse spezifisch ist. Das Datenstrukturobjekt speichert die aktuelle Konfiguration eines Medienstreamgeräts, das dem Zeilengerät zugeordnet ist.
Syntax
LONG lineGetDevConfig(
DWORD dwDeviceID,
LPVARSTRING lpDeviceConfig,
LPCSTR lpszDeviceClass
);
Parameter
dwDeviceID
Bezeichner des zu konfigurierenden Leitungsgeräts.
lpDeviceConfig
Zeiger auf den Speicherspeicherort des Typs VARSTRING , an dem die Gerätekonfigurationsstruktur zurückgegeben wird. Nach erfolgreichem Abschluss der Anforderung wird dieser Speicherort mit der Gerätekonfiguration gefüllt. Das dwStringFormat-Element in der VARSTRING-Struktur ist auf STRINGFORMAT_BINARY festgelegt. Vor dem Aufrufen von lineGetDevConfig muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, die TAPI zum Zurückgeben von Informationen zur Verfügung steht.
lpszDeviceClass
Zeiger auf eine NULL-Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Konfiguration angefordert wird. Gültige LineGetID-Zeichenfolgen der Geräteklasse sind mit den für die Funktion angegebenen Zeichenfolgen identisch.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NODEVICE.
Hinweise
Anrufzustände sind gerätespezifisch.
Die lineGetDevConfig-Funktion kann verwendet werden, um eine Datenstruktur aus TAPI abzurufen, die die Konfiguration eines Medienstreamgeräts angibt, das einem bestimmten Leitungsgerät zugeordnet ist. Der Inhalt dieser Struktur könnte beispielsweise Datenrate, Zeichenformat, Modulationsschemas und Fehlersteuerungsprotokolleinstellungen für ein der Zeile zugeordnetes "Datamodem"-Mediengerät angeben.
In der Regel ruft eine Anwendung lineGetID auf, um das Medienstreamgerät zu identifizieren, das einer Zeile zugeordnet ist, und ruft dann lineConfigDialog auf, damit der Benutzer die Gerätekonfiguration einrichten kann. Anschließend kann lineGetDevConfig aufgerufen und die Konfigurationsinformationen in einem Telefonbuch (oder einer anderen Datenbank) gespeichert werden, das einem bestimmten Anrufziel zugeordnet ist. Wenn der Benutzer dasselbe Ziel später erneut aufrufen möchte, kann lineSetDevConfig verwendet werden, um die vom Benutzer ausgewählten Konfigurationseinstellungen wiederherzustellen. Die Funktionen lineSetDevConfig, lineConfigDialog und lineGetDevConfig können in dieser Reihenfolge verwendet werden, damit der Benutzer die Einstellungen anzeigen und aktualisieren kann.
Das genaue Format der in der Struktur enthaltenen Daten ist spezifisch für die Zeilen- und Medienstream-API (Geräteklasse), ist nicht dokumentiert und nicht definiert. Auf die von dieser Funktion zurückgegebene Struktur kann nicht direkt von der Anwendung zugegriffen oder bearbeitet werden, sondern nur intakt gespeichert und später in lineSetDevConfig verwendet werden, um die Einstellungen wiederherzustellen. Die Struktur kann auch nicht unbedingt an andere Geräte übergeben werden, auch nicht an dieselbe Geräteklasse (obwohl dies in einigen Fällen funktionieren kann, ist dies nicht garantiert).
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | tapi.h |
Bibliothek | Tapi32.lib |
DLL | Tapi32.dll |
Weitere Informationen
Referenz zu Grundlegenden Telefoniediensten