mcx.h) (MODEMDEVCAPS 结构

项目
08/24/2023

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

语法

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

通过