fungsi lineSetDevConfig (tapi.h)

Artikel
03/02/2024

Fungsi lineSetDevConfig memungkinkan aplikasi untuk memulihkan konfigurasi perangkat aliran media pada perangkat baris ke pengaturan yang diperoleh sebelumnya menggunakan lineGetDevConfig. Misalnya, konten struktur ini dapat menentukan tingkat data, format karakter, skema modulasi, dan pengaturan protokol kontrol kesalahan untuk perangkat media "datamodem" yang terkait dengan baris.

Sintaks

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

Parameter

dwDeviceID

Pengidentifikasi perangkat baris yang akan dikonfigurasi.

lpDeviceConfig

Penunjuk ke struktur data konfigurasi buram yang dikembalikan oleh lineGetDevConfig dalam bagian variabel struktur VARSTRING .

dwSize

Jumlah byte dalam struktur yang diacu oleh lpDeviceConfig. Nilai ini dikembalikan dalam anggota dwStringSize dalam struktur VARSTRING yang dikembalikan oleh lineGetDevConfig.

lpszDeviceClass

Penunjuk ke string yang dihentikan null yang menentukan kelas perangkat perangkat yang konfigurasinya akan diatur. String kelas perangkat yang valid sama dengan yang ditentukan untuk fungsi lineGetID .

Nilai kembali

Mengembalikan nol jika fungsi berhasil atau angka kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_NODEVICE.

Keterangan

Status panggilan spesifik perangkat.

Biasanya, aplikasi memanggil lineGetID untuk mengidentifikasi perangkat aliran media yang terkait dengan baris, lalu memanggil lineConfigDialog untuk memungkinkan pengguna menyiapkan konfigurasi perangkat. Kemudian dapat memanggil lineGetDevConfig dan menyimpan informasi konfigurasi dalam buku telepon atau database lain yang terkait dengan tujuan panggilan tertentu. Ketika pengguna ingin memanggil tujuan yang sama lagi, fungsi lineSetDevConfig ini dapat digunakan untuk memulihkan pengaturan konfigurasi yang dipilih oleh pengguna. Fungsi lineSetDevConfig, lineConfigDialog, dan lineGetDevConfig dapat digunakan, dalam urutan tersebut, untuk memungkinkan pengguna melihat dan memperbarui pengaturan.

Format data yang tepat yang terkandung dalam struktur khusus untuk API aliran baris dan media (kelas perangkat), tidak terdokumentasi, dan tidak terdefinis. Aplikasi harus memperlakukannya sebagai "buram" dan tidak memanipulasi konten secara langsung. Umumnya, struktur dapat dikirim menggunakan fungsi ini hanya ke perangkat yang sama dari mana struktur tersebut diperoleh. Namun, penyedia layanan telepon tertentu dapat mengizinkan struktur untuk dipertukarkan antara perangkat yang identik (yaitu, beberapa port pada kartu modem multiport yang sama). Pertukaran tersebut tidak dijamin dengan cara apa pun, bahkan untuk perangkat dengan kelas perangkat yang sama.

Beberapa penyedia layanan mungkin mengizinkan konfigurasi diatur saat panggilan aktif, dan yang lain mungkin tidak.