Bagikan melalui

Struktur MODEMSETTINGS (mcx.h)

  • Artikel

Berisi informasi tentang konfigurasi modem.

Sintaks

typedef struct _MODEMSETTINGS {
  DWORD dwActualSize;
  DWORD dwRequiredSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDevSpecificSize;
  DWORD dwCallSetupFailTimer;
  DWORD dwInactivityTimeout;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerMode;
  DWORD dwPreferredModemOptions;
  DWORD dwNegotiatedModemOptions;
  DWORD dwNegotiatedDCERate;
  BYTE  abVariablePortion[1];
} MODEMSETTINGS, *PMODEMSETTINGS, *LPMODEMSETTINGS;

Anggota

dwActualSize

Ukuran data benar-benar dikembalikan ke aplikasi, dalam byte. Anggota ini mungkin kurang dari anggota dwRequiredSize jika aplikasi tidak mengalokasikan cukup ruang untuk bagian panjang variabel struktur.

dwRequiredSize

Jumlah byte yang diperlukan untuk seluruh struktur MODEMDEVCAPS , termasuk bagian panjang variabel.

dwDevSpecificOffset

Offset bagian struktur yang ditentukan penyedia, dalam byte relatif terhadap awal struktur.

dwDevSpecificSize

Ukuran bagian struktur yang ditentukan penyedia, dalam byte.

dwCallSetupFailTimer

Jumlah detik maksimum modem harus menunggu, setelah panggilan selesai, untuk indikasi bahwa koneksi modem-ke-modem telah dibuat. Jika koneksi tidak dibuat dalam interval ini, panggilan diasumsikan gagal. Anggota ini setara dengan mendaftarkan S7 dalam modem yang kompatibel dengan Hayes®.

dwInactivityTimeout

Jumlah maksimum detik tidak aktif yang diizinkan setelah koneksi dibuat. Jika tidak ada data yang dikirimkan atau diterima untuk jangka waktu ini, panggilan akan dihentikan secara otomatis. Waktu habis ini digunakan untuk menghindari biaya jarak jauh yang berlebihan atau biaya layanan online jika aplikasi tiba-tiba terkunci atau pengguna pergi.

dwSpeakerVolume

Tingkat volume speaker monitor saat speaker menyala. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
MDMVOL_HIGH
0x00000002
 Volume tinggi.
MDMVOL_LOW
0x00000000
 Volume rendah.
MDMVOL_MEDIUM
0x00000001
 Volume sedang.
 

Struktur MODEMDEVCAPS menentukan volume speaker yang didukung modem. Volume aktual adalah khusus perangkat keras.

dwSpeakerMode

Mode speaker. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
MDMSPKR_CALLSETUP
0x00000008
 Speaker menyala hingga koneksi dibuat.
MDMSPKR_DIAL
0x00000002
 Speaker menyala sampai koneksi dibuat, kecuali bahwa itu mati saat modem benar-benar memutar nomor.
MDMSPKR_OFF
0x00000001
 Speaker selalu nonaktif.
MDMSPKR_ON
0x00000004
 Pembicara selalu menyala.

dwPreferredModemOptions

Opsi modem yang diminta oleh aplikasi. Modem lokal dan jarak jauh menegosiasikan opsi modem selama penyiapan panggilan; anggota ini menentukan posisi negosiasi awal modem lokal.

Anggota dwModemOptions dari struktur MODEMDEVCAPS menentukan opsi modem yang didukung oleh modem lokal. Untuk daftar opsi modem, lihat deskripsi struktur MODEMDEVCAPS .

dwNegotiatedModemOptions

Opsi modem yang benar-benar berlaku. Anggota ini diisi setelah koneksi dibuat dan modem lokal dan jarak jauh menegosiasikan opsi modem.

Anggota dwModemOptions dari struktur MODEMDEVCAPS menentukan opsi modem yang didukung oleh modem lokal. Untuk daftar opsi modem, lihat deskripsi struktur MODEMDEVCAPS .

dwNegotiatedDCERate

Tingkat DCE berlaku. Anggota ini diisi setelah koneksi dibuat dan modem lokal dan jarak jauh menegosiasikan modulasi modem.

abVariablePortion[1]

Informasi opsional yang ditentukan penyedia.

Persyaratan

   
Klien minimum yang didukung Windows XP
Server minimum yang didukung Windows Server 2003
Header mcx.h (termasuk Windows.h)

Lihat juga

MODEMDEVCAPS