Struktur MODEMDEVCAPS (mcx.h)

Artikel
03/09/2024

Berisi informasi tentang kemampuan modem.

Sintaks

typedef struct _MODEMDEVCAPS {
  DWORD dwActualSize;
  DWORD dwRequiredSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDevSpecificSize;
  DWORD dwModemProviderVersion;
  DWORD dwModemManufacturerOffset;
  DWORD dwModemManufacturerSize;
  DWORD dwModemModelOffset;
  DWORD dwModemModelSize;
  DWORD dwModemVersionOffset;
  DWORD dwModemVersionSize;
  DWORD dwDialOptions;
  DWORD dwCallSetupFailTimer;
  DWORD dwInactivityTimeout;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerMode;
  DWORD dwModemOptions;
  DWORD dwMaxDTERate;
  DWORD dwMaxDCERate;
  BYTE  abVariablePortion[1];
} MODEMDEVCAPS, *PMODEMDEVCAPS, *LPMODEMDEVCAPS;

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.

dwModemProviderVersion

Versi penyedia layanan. Format dan penggunaan anggota ini tergantung pada penyedia layanan.

dwModemManufacturerOffset

Offset string teks yang berisi nama produsen modem, dalam byte relatif terhadap awal struktur.

dwModemManufacturerSize

Panjang nama produsen modem, dalam byte. String tidak dihentikan null.

dwModemModelOffset

Offset string teks yang berisi model modem, dalam byte relatif terhadap awal struktur.

dwModemModelSize

Panjang nama model, dalam byte. String tidak dihentikan null.

dwModemVersionOffset

Offset string teks yang memberikan versi dan revisi modem terlampir, jika penyedia dapat menentukan informasi. Offset ditentukan dalam byte relatif terhadap awal struktur.

dwModemVersionSize

Panjang string versi modem, dalam byte. String tidak dihentikan null.

dwDialOptions

Opsi pemutaran yang didukung oleh perangkat modem. Anggota ini bisa nol atau lebih dari nilai berikut.

Nilai	Makna
DIALOPTION_BILLING 0x00000040	Modem mendukung menunggu nada penagihan (bong).
DIALOPTION_DIALTONE 0x00000100	Modem mendukung menunggu nada putar-nomor.
DIALOPTION_QUIET 0x00000080	Modem mendukung menunggu diam.

dwCallSetupFailTimer

Batas waktu penyetelan panggilan maksimum yang didukung oleh modem, dalam detik. Ini adalah nilai terbesar yang dapat ditentukan untuk anggota struktur MODEMSETTINGS yang sesuai.

dwInactivityTimeout

Batas waktu tidak aktif maksimum yang didukung oleh modem, dalam sepuluh detik. Ini adalah nilai terbesar yang dapat ditentukan untuk anggota struktur MODEMSETTINGS yang sesuai.

dwSpeakerVolume

Pengaturan volume speaker yang didukung oleh modem. Anggota ini bisa nol atau lebih dari nilai berikut.

Nilai	Makna
MDMVOLFLAG_HIGH 0x00000004	Modem mendukung volume tinggi (MDMVOL_HIGH).
MDMVOLFLAG_LOW 0x00000001	Modem mendukung volume rendah (MDMVOL_LOW).
MDMVOLFLAG_MEDIUM 0x00000002	Modem mendukung volume sedang (MDMVOL_MEDIUM).

dwSpeakerMode

Pengaturan mode speaker yang didukung oleh modem. Anggota ini bisa nol atau lebih dari nilai berikut.

Nilai	Makna
MDMSPKRFLAG_CALLSETUP 0x00000008	Modem mendukung mode speaker MDMSPKR_CALLSETUP.
MDMSPKRFLAG_DIAL 0x00000002	Modem mendukung mode speaker MDMSPKR_DIAL.
MDMSPKRFLAG_OFF 0x00000001	Modem mendukung mode speaker MDMSPKR_OFF.
MDMSPKRFLAG_ON 0x00000004	Modem mendukung mode speaker MDMSPKR_ON.

dwModemOptions

Opsi modem. Anggota ini bisa nol atau lebih dari nilai berikut.

MDM_BLIND_DIAL (0x00000200)

MDM_CCITT_OVERRIDE (0x00000040)

MDM_CELLULAR (0x00000008)

MDM_COMPRESSION (0x00000001)

MDM_DIAGNOSTICS (0x000000800)

MDM_ERROR_CONTROL (0x00000002)

MDM_FLOWCONTROL_HARD (0x00000010)

MDM_FLOWCONTROL_SOFT (0x00000020)

MDM_FORCED_EC (0x00000004)

MDM_SPEED_ADJUST (0x00000080)

MDM_TONE_DIAL (0x00000100)

MDM_V23_OVERRIDE (0x00000400)

Ketika MODEMDEVCAPS digunakan untuk mengatur opsi modem, sebagai bagian dari struktur MODEMSETTINGS , nilai-nilai ini digunakan sebagai berikut.

Nilai	Makna
MDM_CCITT_OVERRIDE 0x00000040	Saat diatur, modulasi CCITT diaktifkan untuk V.21 dan V.22 atau V.23. Ketika jelas, modulasi bel diaktifkan untuk 103 dan 212A.
MDM_V23_OVERRIDE 0x00000400	Saat diatur, modulasi CCITT diaktifkan untuk V.23. Saat dihapus, modulasi CCITT diaktifkan untuk V.21 dan V.22.

Agar V.23 diatur, MDM_CCITT_OVERRIDE dan MDM_V23_OVERRIDE harus diatur.

dwMaxDTERate

Laju DTE maksimum dalam bit per detik.

dwMaxDCERate

Tingkat DCE maksimum dalam bit per detik.

abVariablePortion[1]

Informasi panjang variabel, termasuk string dan informasi yang ditentukan penyedia apa pun.

Persyaratan

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

Lihat juga

MODEMSETTINGS

Bagikan melalui