lineGetDevConfig-Funktion (tapi.h)

Artikel
03/04/2024

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.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema Speicherzuordnung .

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).