MODEMSETTINGS结构包含有关调制解调器配置的信息。
typedef struct modemsettings_tag {
DWORD dwActualSize; //返回数据的大小(以字节为单位)
DWORD dwRequiredSize; //结构总体尺寸
DWORD dwDevSpecificOffset; //提供者定义的数据的偏移量
DWORD dwDevSpecificSize; //提供者定义数据的大小
//静态本地选项(读/写)
DWORD dwCallSetupFailTimer; //调用setup timeout,以秒为单位
DWORD dwInactivityTimeout; //不活动超时,以秒为单位
DWORD dwSpeakerVolume; //扬声器音量级别
DWORD dwSpeakerMode; //扬声器模式
DWORD dwPreferredModemOptions; //位图指定首选项
//当前或最后一次通话的协商选项(只读)
DWORD dwNegotiatedModemOptions; //位图指定实际选项
DWORD dwNegotiatedDCERate; // DCE速率,以位/秒为单位
//专有扩展的变量部分
BYTE abVariablePortion[1]; //可变长度数据
} MODEMSETTINGS, *PMODEMSETTINGS, *LPMODEMSETTINGS;
会员
dwActualSize
指定实际返回给应用程序的数据的大小(以字节为单位)。如果应用程序没有为结构的可变长度部分分配足够的空间,则此成员可能小于dwRequiredSize成员。
dwRequiredSize
指定整个MODEMDEVCAPS结构所需的字节数,包括可变长度部分。
dwDevSpecificOffset
指定结构的提供者定义部分的偏移量,以相对于结构开头的字节为单位。
dwDevSpecificSize
指定结构的提供者定义部分的大小(以字节为单位)。
dwCallSetupFailTimer
指定在拨号完成后,调制解调器应等待调制解调器到调制解调器连接的指示的最大秒数。如果在此间隔内未建立连接,则称该呼叫已失败。该成员相当于在Hayes兼容调制解调器中注册S7。
dwInactivityTimeout
指定建立连接后允许的最大不活动秒数。如果在这段时间内没有发送或接收到数据,则呼叫将自动终止。如果应用程序意外锁定或用户离开,则此超时用于避免过长的长途费用或在线服务费用。
dwSpeakerVolume
指定扬声器开启时显示器扬声器的音量。该成员可以是以下值之一:
值 | 含义 |
MDMVOL_LOW | 小声。 |
MDMVOL_MEDIUM | 中等体积。 |
MDMVOL_HIGH | 高音量。 |
MODEMDEVCAPS结构指定调制解调器支持的扬声器音量。实际卷是硬件特定的。
dwSpeakerMode
指定扬声器何时开启。该成员可以是以下值之一:
值 | 含义 |
MDMSPKR_OFF | 扬声器总是关闭。 |
MDMSPKR_CALLSETUP | 扬声器打开,直到建立连接。 |
MDMSPKR_ON | 扬声器始终开启。 |
MDMSPKR_DIAL | 扬声器打开,直到建立连接,除了在调制解调器实际拨号时它关闭。 |
dwPreferredModemOptions
指定应用程序请求的调制解调器选项。本地和远程调制解调器在呼叫建立期间协商调制解调器选项;该成员指定本地调制解调器的初始协商位置。
MODEMDEVCAPS结构的dwModemOptions成员指定了本地调制解调器支持的调制解调器选项。有关调制解调器选项的列表,请参阅MODEMDEVCAPS结构的说明。
dwNegotiatedModemOptions
指定实际有效的调制解调器选项。建立连接后,该成员将被填写,并且本地和远程调制解调器协商调制解调器选项。
dwModemOptions结构的dwModemOptions成员指定了本地调制解调器支持的调制解调器选项。有关调制解调器选项的列表,请参阅MODEMDEVCAPS结构的说明。
dwNegotiatedDCERate
指定有效的DCE速率。建立连接后,该成员将被填写,并且本地和远程调制解调器协商调制解调器。
abVariablePortion
包含提供者定义的信息(如果有)。
也可以看看