Структура MODEMSETTINGS

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

Синтаксис

typedef struct modemsettings_tag {
  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_LOW Низкая громкость звука.
MDMVOL_MEDIUM Средняя громкость звука.
MDMVOL_HIGH Высокая  громкость звука.

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

dwSpeakerMode
Режим громкоговорителя. Этот член структуры может быть одним из ниже перечисленных значений.

 

Значение Предназначение
MDMSPKR_OFF Динамик всегда выключен.
MDMSPKR_DIAL Динамик включен до тех пор, пока не установится соединение, за исключением того, что он выключается, в то время, когда модем действительно набирает номер.
MDMSPKR_ON Динамик всегда включен.
MDMSPKR_CALLSETUP Динамик включен до тех пор, пока не установится соединение.
dwPreferredModemOptions

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

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

dwNegotiatedModemOptions

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

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

dwNegotiatedDCERate

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

abVariablePortion

Дополнительная определяемая поставщиком информация.

Смотри также

Обзор Коммуникационные ресурсы, Структуры, используемые коммуникационными ресурсами, MODEMDEVCAPS

Размещение и совместимость MODEMSETTINGS

К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 4.0
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
 
С

Windows 2003 Server

Да
е

Windows 2000 Server

Да 
р

Windows NT Server

Да версии 4.0
в

 

 
е

 

 
р 

 

 
 

Используемая библиотека

-

 

Заголовочный файл

 
 

- объявлено в

Mcx.h

 

- включено в

Windows.h

 

Unicode

-

 

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz