lineSetDevConfigW-Funktion (tapi.h)

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

Syntax

LONG lineSetDevConfigW(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCWSTR      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-Element in der VARSTRING-Struktur zurückgegeben, die von lineGetDevConfig zurückgegeben wird.

lpszDeviceClass

Zeiger auf eine NULL-endende Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Konfiguration festgelegt werden soll. Gültige Geräteklassenzeichenfolgen sind identisch mit denen, die für die lineGetID-Funktion angegeben sind.

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 medienstream-Gerät zu identifizieren, das einer Leitung 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), 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 den Austausch von Strukturen zwischen identischen Geräten zulassen (d. a. mehrere Ports an demselben Multiportmodem Karte). Eine solche Austauschbarkeit wird in keiner Weise garantiert, auch nicht für Geräte derselben Geräteklasse.

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

Hinweis

Der tapi.h-Header definiert lineSetDevConfig als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi.h
Bibliothek	Tapi32.lib
DLL	Tapi32.dll

Weitere Informationen

Grundlegende Referenz zu Telefoniediensten

ÜBERSICHT ÜBER TAPI 2.2-Referenz

VARSTRING

lineConfigDialog

lineGetDevConfig

lineGetID