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

Статья
08/24/2023

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

Синтаксис

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)

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

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

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