mcx.h) (MODEMDEVCAPS 结构

  • 项目

包含有关调制解调器功能的信息。

语法

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

调制解调器制造商名称的长度（以字节为单位）。 字符串不是以 null 结尾的。

dwModemModelOffset

包含调制解调器模型的文本字符串的偏移量，以字节为单位，相对于结构开头。

dwModemModelSize

模型名称的长度（以字节为单位）。 字符串不是以 null 结尾的。

dwModemVersionOffset

提供附加调制解调器的版本和修订版本的文本字符串的偏移量（如果提供程序可以确定信息）。 相对于结构的开头，偏移量以字节为单位指定。

dwModemVersionSize

调制解调器版本字符串的长度（以字节为单位）。 字符串不是以 null 结尾的。

dwDialOptions

调制解调器设备支持的拨号选项。 此成员可以是以下值的零个或多个。

值 含义
DIALOPTION_BILLING
0x00000040
 调制解调器支持等待计费音 (bong) 。
DIALOPTION_DIALTONE
0x00000100
 调制解调器支持等待拨号音。
DIALOPTION_QUIET
0x00000080
 调制解调器支持等待安静。

dwCallSetupFailTimer

调制解调器支持的最大呼叫设置超时时间（以秒为单位）。 这是可以为 MODEMSETTINGS 结构的相应成员指定的最大值。

dwInactivityTimeout

调制解调器支持的最大非活动超时，以十分之一秒为单位。 这是可以为 MODEMSETTINGS 结构的相应成员指定的最大值。

dwSpeakerVolume

调制解调器支持的扬声器音量设置。 此成员可以是以下值的零个或多个。

值 含义
MDMVOLFLAG_HIGH
0x00000004
 调制解调器支持高 (MDMVOL_HIGH) 音量。
MDMVOLFLAG_LOW
0x00000001
 调制解调器支持低 (MDMVOL_LOW) 音量。
MDMVOLFLAG_MEDIUM
0x00000002
 调制解调器支持中等 (MDMVOL_MEDIUM) 音量。

dwSpeakerMode

调制解调器支持的扬声器模式设置。 此成员可以是以下值的零个或多个。

值 含义
MDMSPKRFLAG_CALLSETUP
0x00000008
 调制解调器支持MDMSPKR_CALLSETUP扬声器模式。
MDMSPKRFLAG_DIAL
0x00000002
 调制解调器支持MDMSPKR_DIAL扬声器模式。
MDMSPKRFLAG_OFF
0x00000001
 调制解调器支持MDMSPKR_OFF扬声器模式。
MDMSPKRFLAG_ON
0x00000004
 调制解调器支持MDMSPKR_ON扬声器模式。

dwModemOptions

调制解调器选项。 此成员可以是以下值的零个或多个。

MDM_BLIND_DIAL (0x00000200)

MDM_CCITT_OVERRIDE (0x00000040)

MDM_CELLULAR (0x00000008)

MDM_COMPRESSION (0x00000001)

MDM_DIAGNOSTICS (0x000000800)

MDM_ERROR_CONTROL (0x00000002)

MDM_FLOWCONTROL_HARD (0x00000010)

MDM_FLOWCONTROL_SOFT (0x00000020)

MDM_FORCED_EC (0x00000004)

MDM_SPEED_ADJUST (0x00000080)

MDM_TONE_DIAL (0x00000100)

MDM_V23_OVERRIDE (0x00000400)

当 MODEMDEVCAPS 用于设置调制解调器选项时，作为 MODEMSETTINGS 结构的一部分，这些值将按如下所示使用。

值 含义
MDM_CCITT_OVERRIDE
0x00000040
 设置后，将针对 V.21 和 V.22 或 V.23 启用 CCITT 调制。

清除时，为 103 和 212A 启用钟式调制。
MDM_V23_OVERRIDE
0x00000400
 设置后，为 V.23 启用 CCITT 调制。

清除后，会为 V.21 和 V.22 启用 CCITT 调制。
 

若要设置 V.23，必须同时设置 MDM_CCITT_OVERRIDE 和 MDM_V23_OVERRIDE。

dwMaxDTERate

最大 DTE 速率（以位/秒为单位）。

dwMaxDCERate

最大 DCE 速率（以位/秒为单位）。

abVariablePortion[1]

可变长度信息，包括字符串和任何提供程序定义的信息。

要求

要求 值
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
标头 mcx.h (包括 Windows.h)

另请参阅

MODEMSETTINGS