lineSetDevConfig-Funktion (tapi.h)

Artikel
03/04/2024

Mit der lineSetDevConfig-Funktion kann die Anwendung die Konfiguration eines Mediendatenstromgeräts auf einem Zeilengerät in einem Setup wiederherstellen, das zuvor mit lineGetDevConfig abgerufen wurde. Der Inhalt dieser Struktur könnte beispielsweise Datenrate, Zeichenformat, Modulationsschemas und Fehlersteuerungsprotokolleinstellungen für ein der Zeile zugeordnetes "Datamodem"-Mediengerät angeben.

Syntax

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

Parameter

dwDeviceID

Bezeichner des zu konfigurierenden Leitungsgeräts.

lpDeviceConfig

Zeiger auf die undurchsichtige Konfigurationsdatenstruktur, die von lineGetDevConfig im Variablenteil der VARSTRING-Struktur zurückgegeben wurde.

dwSize

Anzahl der Bytes in der Struktur, auf die von lpDeviceConfig verwiesen wird. Dieser Wert wird im dwStringSize-Member in der VARSTRING-Struktur zurückgegeben, die von lineGetDevConfig zurückgegeben wird.

lpszDeviceClass

Zeiger auf eine NULL-Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Konfiguration festgelegt werden soll. Gültige Geräteklassenzeichenfolgen sind mit den für die lineGetID-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_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_NODEVICE.

Hinweise

Anrufzustände sind gerätespezifisch.

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 könnte lineGetDevConfig aufgerufen und die Konfigurationsinformationen in einem Telefonbuch oder einer anderen Datenbank gespeichert werden, die einem bestimmten Anrufziel zugeordnet ist. Wenn der Benutzer dasselbe Ziel erneut aufrufen möchte, kann diese lineSetDevConfig-Funktion 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. Die Anwendung muss sie als "undurchsichtig" behandeln und den Inhalt nicht direkt bearbeiten. Im Allgemeinen kann die Struktur mit dieser Funktion nur an dasselbe Gerät gesendet werden, von dem sie abgerufen wurde. Bestimmte Telefoniedienstanbieter können jedoch zulassen, dass Strukturen zwischen identischen Geräten ausgetauscht werden (d. a. mehrere Ports auf demselben Multiportmodem Karte). Eine solche Austauschbarkeit ist auch bei Geräten derselben Geräteklasse in keiner Weise garantiert.

Einige Dienstanbieter erlauben möglicherweise, dass die Konfiguration festgelegt wird, während ein Anruf aktiv ist, andere nicht.