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

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

  • Статья

Содержит сведения о конфигурации модема.

Синтаксис

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;

Члены

dwActualSize

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

dwRequiredSize

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

dwDevSpecificOffset

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

dwDevSpecificSize

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

dwCallSetupFailTimer

Максимальное время в секундах, в течение которого модем должен ждать после завершения набора номера, чтобы указать, что подключение модема к модему установлено. Если соединение не установлено в этот интервал, предполагается, что вызов завершился сбоем. Этот член эквивалентен регистрации S7 в модемах, совместимых с Hayes®.

dwInactivityTimeout

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

dwSpeakerVolume

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

Значение Значение
MDMVOL_HIGH
0x00000002
 Большой объем.
MDMVOL_LOW
0x00000000
 Низкий объем.
MDMVOL_MEDIUM
0x00000001
 Средний объем.
 

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

dwSpeakerMode

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

Значение Значение
MDMSPKR_CALLSETUP
0x00000008
 Динамик будет включен до тех пор, пока не будет установлено подключение.
MDMSPKR_DIAL
0x00000002
 Динамик будет включен до тех пор, пока не будет установлено подключение, за исключением того, что он отключен, пока модем фактически набирает номер.
MDMSPKR_OFF
0x00000001
 Динамик всегда отключен.
MDMSPKR_ON
0x00000004
 Динамик всегда включен.

dwPreferredModemOptions

Параметры модема, запрошенные приложением. Локальные и удаленные модемы согласовывают параметры модема во время настройки вызова; этот элемент задает начальную позицию переговоров локального модема.

Член dwModemOptions структуры MODEMDEVCAPS определяет параметры модема, поддерживаемые локальным модемом. Список параметров модема см. в описании структуры MODEMDEVCAPS .

dwNegotiatedModemOptions

Фактические параметры модема. Этот элемент заполняется после установки подключения, а локальные и удаленные модемы согласовывают параметры модема.

Член dwModemOptions структуры MODEMDEVCAPS определяет параметры модема, поддерживаемые локальным модемом. Список параметров модема см. в описании структуры MODEMDEVCAPS .

dwNegotiatedDCERate

Действивная скорость DCE. Этот элемент заполняется после установки подключения и согласования модуляций модема между локальными и удаленными модемами.

abVariablePortion[1]

Необязательные сведения, определяемые поставщиком.

Требования

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

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

МОДЕМDEVCAPS