Структура MODEMDEVCAPS

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

Синтаксис

typedef struct modemdevcaps_tag {
  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

Длина заводского названия модема, в байтах. У строки - нет нуль-терминатора  ('0').

dwModemModelOffset

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

dwModemModelSize

Длина названия модели, в байтах.  У строки - нет нуль-терминатора  ('0').

dwModemVersionOffset

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

dwModemVersionSize

Длина символьной строки  о версии модема, в байтах.   У строки - нет нуль-терминатора  ('0').

dwDialOptions

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

 

Значение Предназначение
DIALOPTION_BILLING Модем поддерживает ожидание тонального сигнала регистрации (телефонный звонок).
DIALOPTION_QUIET Модем поддерживает ожидание  состояния покоя.
DIALOPTION_DIALTONE Модем поддерживает ожидание  тонального сигнала готовности.
dwCallSetupFailTimer

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

dwInactivityTimeout

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

dwSpeakerVolume

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

Значение Предназначение
MDMVOLFLAG_LOW Модем поддерживает низкую громкость звука (MDMVOL_LOW).
MDMVOLFLAG_MEDIUM Модем поддерживает среднюю (MDMVOL_MEDIUM) громкость звука.
MDMVOLFLAG_HIGH Модем поддерживает высокую (MDMVOL_HIGH) громкость звука.
dwSpeakerMode
Параметры режима динамика ПК, поддерживаемые модемом. Этот член структуры может равняться нулю или чаще ниже перечисленным значениям.

 

Значение Предназначение
MDMSPKRFLAG_OFF Модем поддерживает режим спикера MDMSPKR_OFF.
MDMSPKRFLAG_DIAL Модем поддерживает режим спикера MDMSPKR_DIAL.
MDMSPKRFLAG_ON Модем поддерживает режим спикера MDMSPKR_ON.
MDMSPKRFLAG_CALLSETUP Модем поддерживает режим спикера MDMSPKR_CALLSETUP.
dwModemOptions
Параметры модема. Этот член структуры может равняться нулю или чаще ниже перечисленным значениям:

 

MDM_BLIND_DIAL
MDM_FLOWCONTROL_SOFT
MDM_CCITT_OVERRIDE
MDM_FORCED_EC
MDM_CELLULAR
MDM_SPEED_ADJUST
MDM_COMPRESSION
MDM_TONE_DIAL
MDM_ERROR_CONTROL
MDM_V23_OVERRIDE
MDM_FLOWCONTROL_HARD

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

 

Значение Предназначение
MDM_CCITT_OVERRIDE Когда флажок установлен,  модуляции CCITT разрешаются для протоколов V.21 и V.22 или V.23.

Когда сбрасывается, модуляции звонка разрешаются для протоколов 103 и 212A.

MDM_V23_OVERRIDE Когда флажок установлен,  модуляции CCITT разрешаются для протокола V.22 или V.23.

Когда сбрасывается,  модуляции  разрешаются для протоколов V.21 и V.22.

Чтобы установить для V.23, должен быть установлен и MDM_CCITT_OVERRIDE, и MDM_V23_OVERRIDE .

 

dwMaxDTERate

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

dwMaxDCERate
Максимальная скорость DСE, в битах за секунду.
abVariablePortion

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

Смотри также

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

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

К

Windows. NET Server

-

л

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