MODEMSETTINGS 结构 (mcx.h)
包含有关调制解调器配置的信息。
语法
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
拨号完成后，调制解调器应等待的最大秒数，指示已建立调制解调器到调制解调器的连接。 如果未在此间隔内建立连接，则假定调用失败。 此成员等效于在 Hayes® 兼容的调制解调器中注册 S7。
dwInactivityTimeout
建立连接后允许的最大非活动秒数。 如果此时间段内未传输或接收任何数据，则调用将自动终止。 此超时用于避免在应用程序意外锁定或用户离开时产生过高的长途费用或联机服务费用。
dwSpeakerVolume
打开扬声器时监视器扬声器的音量级别。 此成员可以是以下值之一。
| 值 | 含义 |
|---|---|
|
高音量。 |
|
低音量。 |
|
中等音量。 |
MODEMDEVCAPS 结构指定调制解调器支持的扬声器音量。 实际卷特定于硬件。
dwSpeakerMode
扬声器模式。 此成员可以是以下值之一。
| 值 | 含义 |
|---|---|
|
在建立连接之前，扬声器处于打开状态。 |
|
扬声器在建立连接之前处于打开状态，但调制解调器实际拨号时扬声器处于关闭状态。 |
|
扬声器始终处于关闭状态。 |
|
扬声器始终处于打开状态。 |
dwPreferredModemOptions
应用程序请求的调制解调器选项。 本地和远程调制解调器在呼叫设置期间协商调制解调器选项;此成员指定本地调制解调器的初始协商位置。
MODEMDEVCAPS 结构的 dwModemOptions 成员指定本地调制解调器支持的调制解调器选项。 有关调制解调器选项的列表，请参阅 MODEMDEVCAPS 结构的说明。
dwNegotiatedModemOptions
实际有效的调制解调器选项。 建立连接并本地和远程调制解调器协商调制解调器选项后，将填充此成员。
MODEMDEVCAPS 结构的 dwModemOptions 成员指定本地调制解调器支持的调制解调器选项。 有关调制解调器选项的列表，请参阅 MODEMDEVCAPS 结构的说明。
dwNegotiatedDCERate
有效的 DCE 速率。 建立连接并且本地和远程调制解调器协商调制解调器调制后，将填充此成员。
abVariablePortion[1]
提供程序定义的可选信息。
要求
| 最低受支持的客户端 | Windows XP |
| 最低受支持的服务器 | Windows Server 2003 |
| 标头 | mcx.h (包括 Windows.h) |