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

Статья
08/24/2023

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

Синтаксис

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

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

dwNegotiatedDCERate

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

abVariablePortion[1]

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

Требования


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

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

МОДЕМDEVCAPS

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