Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die lineGetDevConfig--Funktion gibt ein undurchsichtiges Datenstrukturobjekt zurück, dessen Inhalt spezifisch für die Zeile (Dienstanbieter) und die Geräteklasse sind. Das Datenstrukturobjekt speichert die aktuelle Konfiguration eines medienstream-Geräts, das dem Leitungsgerät zugeordnet ist.
Syntax
LONG lineGetDevConfigW(
DWORD dwDeviceID,
LPVARSTRING lpDeviceConfig,
LPCWSTR lpszDeviceClass
);
Parameter
dwDeviceID
Bezeichner des zu konfigurierenden Leitungsgeräts.
lpDeviceConfig
Zeigen Sie auf den Speicherort des Typs VARSTRING wo die Gerätekonfigurationsstruktur zurückgegeben wird. Nach erfolgreichem Abschluss der Anforderung wird dieser Speicherort mit der Gerätekonfiguration gefüllt. Der dwStringFormat Member in der VARSTRING- Struktur wird auf STRINGFORMAT_BINARY festgelegt. Vor dem Aufrufen lineGetDevConfig-muss die Anwendung die dwTotalSize Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher für TAPI für die Rückgabe von Informationen verfügbar ist.
Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden können. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema Speicherzuordnung Thema.
lpszDeviceClass
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Konfiguration angefordert wird. Gültige Geräteklasse lineGetID- Zeichenfolgen entsprechen denen, die für die Funktion angegeben sind.
Rückgabewert
Gibt Null zurück, wenn die Funktion erfolgreich ist oder eine negative Fehlernummer auftritt, 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.
Bemerkungen
Anrufzustände sind gerätespezifisch.
Die lineGetDevConfig--Funktion kann verwendet werden, um eine Datenstruktur von TAPI abzurufen, die die Konfiguration eines Mediendatenstromgeräts angibt, das einem bestimmten Liniengerät zugeordnet ist. Beispielsweise könnte der Inhalt dieser Struktur Datenrate, Zeichenformat, Modulationsschemas und Fehlersteuerungsprotokolleinstellungen für ein "datamodem"-Mediengerät angeben, das der Zeile zugeordnet ist.
In der Regel ruft eine Anwendung lineGetID- auf, um das Mediendatenstromgerät zu identifizieren, das einer Zeile zugeordnet ist, und ruft dann lineConfigDialog auf, damit der Benutzer die Gerätekonfiguration einrichten kann. Anschließend kann lineGetDevConfigaufgerufen und die Konfigurationsinformationen in einem Telefonbuch (oder einer anderen Datenbank) gespeichert werden, das einem bestimmten Anrufziel zugeordnet ist. Wenn der Benutzer später dasselbe Ziel erneut aufrufen möchte, kann lineSetDevConfig- verwendet werden, um die vom Benutzer ausgewählten Konfigurationseinstellungen wiederherzustellen. Die Funktionen lineSetDevConfig, lineConfigDialogund lineGetDevConfig- können 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 Mediendatenstrom-API (Geräteklasse), ist nicht dokumentiert und ist nicht definiert. Auf die von dieser Funktion zurückgegebene Struktur kann nicht direkt von der Anwendung zugegriffen oder bearbeitet werden, sondern kann nur intakt und später in lineSetDevConfig zum Wiederherstellen der Einstellungen gespeichert werden. Die Struktur kann auch nicht unbedingt an andere Geräte übergeben werden, auch nicht von derselben Geräteklasse (obwohl dies in einigen Fällen funktionieren kann, ist sie nicht garantiert).
Anmerkung
Der header tapi.h definiert lineGetDevConfig 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- | Fenster |
| Header- | tapi.h |
| Library | Tapi32.lib |
| DLL- | Tapi32.dll |