Поделиться через


Структура MODEMDEVCAPS (mcx.h)

Содержит сведения о возможностях модема.

Синтаксис

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;

Члены

dwActualSize

Размер фактически возвращаемых приложению данных в байтах. Этот элемент может быть меньше элемента dwRequiredSize , если приложение не выделило достаточно места для части структуры переменной длины.

dwRequiredSize

Количество байтов, необходимых для всей структуры MODEMDEVCAPS , включая часть переменной длины.

dwDevSpecificOffset

Смещение определяемой поставщиком части структуры в байтах относительно начала структуры.

dwDevSpecificSize

Размер определяемой поставщиком части структуры в байтах.

dwModemProviderVersion

Версия поставщика услуг. Формат и использование этого элемента зависит от поставщика услуг.

dwModemManufacturerOffset

Смещение текстовой строки, содержащей имя изготовителя модема, в байтах относительно начала структуры.

dwModemManufacturerSize

Длина имени изготовителя модема в байтах. Строка не заканчивается null.

dwModemModelOffset

Смещение текстовой строки, содержащей модель модема, в байтах относительно начала структуры.

dwModemModelSize

Длина имени модели в байтах. Строка не заканчивается null.

dwModemVersionOffset

Смещение текстовой строки, указывающей версию и редакцию подключенного модема, если поставщик может определить информацию. Смещение указывается в байтах относительно начала структуры.

dwModemVersionSize

Длина строки версии модема в байтах. Строка не заканчивается null.

dwDialOptions

Параметры набора номера, поддерживаемые модемным устройством. Этот элемент может иметь ноль или более следующих значений.

Значение Значение
DIALOPTION_BILLING
0x00000040
Модем поддерживает ожидание сигнала выставления счетов (bong).
DIALOPTION_DIALTONE
0x00000100
Модем поддерживает ожидание звонка.
DIALOPTION_QUIET
0x00000080
Модем поддерживает ожидание тишины.

dwCallSetupFailTimer

Максимальное время ожидания настройки вызова, поддерживаемого модемом, в секундах. Это наибольшее значение, которое можно указать для соответствующего элемента структуры MODEMSETTINGS .

dwInactivityTimeout

Максимальное время ожидания бездействия, поддерживаемого модемом, в десятых секунд. Это наибольшее значение, которое можно указать для соответствующего элемента структуры MODEMSETTINGS .

dwSpeakerVolume

Параметры громкости динамиков, поддерживаемые модемом. Этот элемент может иметь ноль или более следующих значений.

Значение Значение
MDMVOLFLAG_HIGH
0x00000004
Модем поддерживает высокий (MDMVOL_HIGH) объем.
MDMVOLFLAG_LOW
0x00000001
Модем поддерживает низкий (MDMVOL_LOW) объем.
MDMVOLFLAG_MEDIUM
0x00000002
Модем поддерживает средний (MDMVOL_MEDIUM) том.

dwSpeakerMode

Параметры режима динамиков, поддерживаемые модемом. Этот элемент может иметь ноль или более следующих значений.

Значение Значение
MDMSPKRFLAG_CALLSETUP
0x00000008
Модем поддерживает режим MDMSPKR_CALLSETUP динамиков.
MDMSPKRFLAG_DIAL
0x00000002
Модем поддерживает режим MDMSPKR_DIAL динамиков.
MDMSPKRFLAG_OFF
0x00000001
Модем поддерживает режим MDMSPKR_OFF динамиков.
MDMSPKRFLAG_ON
0x00000004
Модем поддерживает режим MDMSPKR_ON динамиков.

dwModemOptions

Параметры модема. Этот элемент может иметь ноль или более следующих значений.

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)

Если параметр MODEMDEVCAPS используется для задания параметров модема, в рамках структуры MODEMSETTINGS эти значения используются следующим образом.

Значение Значение
MDM_CCITT_OVERRIDE
0x00000040
Если этот параметр задан, модули CCITT включены для V.21 и V.22 или V.23.

Если ясно, модуляция колокола включена для 103 и 212A.

MDM_V23_OVERRIDE
0x00000400
Если этот параметр задан, модуляции CCITT включены для V.23.

Если это ясно, модули CCITT включены для V.21 и V.22.

 

Для установки версии 23 необходимо задать как MDM_CCITT_OVERRIDE, так и MDM_V23_OVERRIDE.

dwMaxDTERate

Максимальная скорость DTE в битах в секунду.

dwMaxDCERate

Максимальная скорость DCE в битах в секунду.

abVariablePortion[1]

Сведения переменной длины, включая строки и любые сведения, определяемые поставщиком.

Требования

Требование Значение
Минимальная версия клиента Windows XP
Минимальная версия сервера Windows Server 2003
Верхняя часть mcx.h (включая Windows.h)

См. также раздел

МОДЕМПАРАМЕТРЫ