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; //以bit / s表示的最大值
DWORD dwMaxDCERate; //以bit / s表示的最大值
//字符串和提供者特定数据的变量部分
BYTE abVariablePortion [1]; //可变长度数据
} MODEMDEVCAPS, *PMODEMDEVCAPS, *LPMODEMDEVCAPS;
会员
dwActualSize
指定实际返回给应用程序的数据的大小(以字节为单位)。如果应用程序没有为结构的可变长度部分分配足够的空间,则该成员可能小于dwRequiredSize成员。
dwRequiredSize
指定整个MODEMDEVCAPS结构所需的字节数,包括可变长度部分。
dwDevSpecificOffset
指定结构的提供者定义部分的偏移量,以相对于结构开头的字节为单位。
dwDevSpecificSize
指定结构的提供者定义部分的大小(以字节为单位)。
dwModemProviderVersion
指定服务提供商的版本。该成员的格式和使用取决于服务提供商。
dwModemManufacturerOffset
指定包含调制解调器制造商名称的文本字符串的偏移量。偏移量以相对于结构开头的字节指定。
dwModemManufacturerSize
指定调制解调器制造商名称的长度(以字节为单位)。字符串不是空终止的。
dwModemModelOffset
指定包含调制解调器型号的文本字符串的偏移量。偏移量以相对于结构开头的字节指定。
dwModemModelSize
指定型号名称的长度(以字节为单位)。字符串不是空终止的。
dwModemVersionOffset
指定提供连接的调制解调器的版本和修订版本的文本字符串的偏移量,如果提供者可以确定信息。偏移量以相对于结构开头的字节指定。
dwModemVersionSize
指定调制解调器版本字符串的长度(以字节为单位)。字符串不是空终止的。
dwDialOptions
指定调制解调器设备支持的拨号选项。该成员可以为零个或多个以下值:
值 | 含义 |
DIALOPTION_DIALBILLING | 指定调制解调器支持等待计费音(bong)。 |
DIALOPTION_DIALQUIET | 指定调制解调器支持等待安静。 |
DIALOPTION_DIALDIALTONE | 指定调制解调器支持等待拨号音。 |
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
指定支持的modem选项。该成员可以为零个或多个以下值:
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.23启用。 清除时,对V.21和V.22启用CCITT调制。 |
要设置V.23,必须设置MDM_CCITT_OVERRIDE和MDM_V23_OVERRIDE。
dwMaxDTERate
最大DTE速率,以位/秒为单位。
dwMaxDCERate
最大DCE速率,以位/秒为单位。
abVariablePortion
包含可变长度的信息,包括字符串和任何提供者定义的信息。
也可以看看