COMMCONFIG 结构 (winbase.h)

包含有关通信设备的配置状态的信息。

语法

typedef struct _COMMCONFIG {
  DWORD dwSize;
  WORD  wVersion;
  WORD  wReserved;
  DCB   dcb;
  DWORD dwProviderSubType;
  DWORD dwProviderOffset;
  DWORD dwProviderSize;
  WCHAR wcProviderData[1];
} COMMCONFIG, *LPCOMMCONFIG;

成员

dwSize

结构大小（以字节为单位）。 调用方必须将此成员设置为 sizeof(COMMCONFIG)。

wVersion

结构的版本号。 此参数可以为 1。 特定于提供程序的结构的版本应包含在 wcProviderData 成员中。

wReserved

保留值；请勿使用。

dcb

设备控制块 (RS-232 串行设备的 DCB) 结构。 无论设备的 COMMPROP 结构中指定的端口驱动程序子类型如何，DCB 结构始终存在。

dwProviderSubType

通信提供程序的类型，以及提供程序特定的数据的格式。 有关通信提供程序类型的列表，请参阅 COMMPROP 结构的说明。

dwProviderOffset

提供程序特定数据相对于结构开头的偏移量（以字节为单位）。 如果没有提供程序特定的数据，则此成员为零。

dwProviderSize

提供程序特定数据的大小（以字节为单位）。

wcProviderData[1]

特定于提供程序的可选数据。 此成员可以是任何大小，也可以省略。 由于将来可能会扩展 COMMCONFIG 结构，因此应用程序应使用 dwProviderOffset 成员来确定此成员的位置。

注解

如果提供程序子类型PST_RS232或PST_PARALLELPORT，则省略 wcProviderData 成员。 如果提供程序子类型PST_MODEM，则 wcProviderData 成员包含 一个 MODEMSETTINGS 结构。

要求

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

另请参阅

COMMPROP

DCB

GetCommProperties

MODEMSETTINGS