包含有关通信驱动程序的信息。
语法
typedef struct _COMMPROP {
WORD wPacketLength;
WORD wPacketVersion;
DWORD dwServiceMask;
DWORD dwReserved1;
DWORD dwMaxTxQueue;
DWORD dwMaxRxQueue;
DWORD dwMaxBaud;
DWORD dwProvSubType;
DWORD dwProvCapabilities;
DWORD dwSettableParams;
DWORD dwSettableBaud;
WORD wSettableData;
WORD wSettableStopParity;
DWORD dwCurrentTxQueue;
DWORD dwCurrentRxQueue;
DWORD dwProvSpec1;
DWORD dwProvSpec2;
WCHAR wcProvChar[1];
} COMMPROP, *LPCOMMPROP;
成员
wPacketLength
整个数据包的大小（无论请求的数据量如何），以字节为单位。
wPacketVersion
结构的版本。
dwServiceMask
一个位掩码，指示此提供程序实现哪些服务。 始终为通信提供商（包括调制解调器提供商 ）指定SP_SERIALCOMM 值。
dwReserved1
保留值；请勿使用。
dwMaxTxQueue
驱动程序的内部输出缓冲区的最大大小（以字节为单位）。 值为零表示串行提供程序未施加任何最大值。
dwMaxRxQueue
驱动程序的内部输入缓冲区的最大大小（以字节为单位）。 值为零表示串行提供程序未施加任何最大值。
dwMaxBaud
允许的最大波特率（以位/秒为单位） (bps) 。 此成员可以是以下值之一。
| 值 |
含义 |
-
BAUD_075
- 0x00000001
|
75 bps |
-
BAUD_110
- 0x00000002
|
110 bps |
-
BAUD_134_5
- 0x00000004
|
134.5 bps |
-
BAUD_150
- 0x00000008
|
150 bps |
-
BAUD_300
- 0x00000010
|
300 bps |
-
BAUD_600
- 0x00000020
|
600 bps |
-
BAUD_1200
- 0x00000040
|
1200 bps |
-
BAUD_1800
- 0x00000080
|
1800 bps |
-
BAUD_2400
- 0x00000100
|
2400 bps |
-
BAUD_4800
- 0x00000200
|
4800 bps |
-
BAUD_7200
- 0x00000400
|
7200 bps |
-
BAUD_9600
- 0x00000800
|
9600 bps |
-
BAUD_14400
- 0x00001000
|
14400 bps |
-
BAUD_19200
- 0x00002000
|
19200 bps |
-
BAUD_38400
- 0x00004000
|
38400 bps |
-
BAUD_56K
- 0x00008000
|
56K bps |
-
BAUD_57600
- 0x00040000
|
57600 bps |
-
BAUD_115200
- 0x00020000
|
115200 bps |
-
BAUD_128K
- 0x00010000
|
128K bps |
-
BAUD_USER
- 0x10000000
|
可编程波特率。
|
dwProvSubType
通信提供程序类型。
| 值 |
含义 |
-
PST_FAX
- 0x00000021
|
FAX 设备 |
-
PST_LAT
- 0x00000101
|
LAT 协议 |
-
PST_MODEM
- 0x00000006
|
调制解调器设备 |
-
PST_NETWORK_BRIDGE
- 0x00000100
|
未指定的网桥 |
-
PST_PARALLELPORT
- 0x00000002
|
并行端口 |
-
PST_RS232
- 0x00000001
|
RS-232 串行端口 |
-
PST_RS422
- 0x00000003
|
RS-422 端口 |
-
PST_RS423
- 0x00000004
|
RS-423 端口 |
-
PST_RS449
- 0x00000005
|
RS-449 端口 |
-
PST_SCANNER
- 0x00000022
|
扫描仪设备 |
-
PST_TCPIP_TELNET
- 0x00000102
|
TCP/IP Telnet 协议 |
-
PST_UNSPECIFIED
- 0x00000000
|
未指定 |
-
PST_X25
- 0x00000103
|
X.25 标准 |
dwProvCapabilities
指示提供程序提供的功能的位掩码。 此成员可以是以下值的组合。
| 值 |
含义 |
-
PCF_16BITMODE
- 0x0200
|
支持特殊 16 位模式 |
-
PCF_DTRDSR
- 0x0001
|
支持 DTR (data-terminal-ready) /DSR (data-set-ready) |
-
PCF_INTTIMEOUTS
- 0x0080
|
支持的间隔超时 |
-
PCF_PARITY_CHECK
- 0x0008
|
支持奇偶校验检查 |
-
PCF_RLSD
- 0x0004
|
支持 RLSD (receive-line-signal-detect) |
-
PCF_RTSCTS
- 0x0002
|
RTS (请求发送) /CTS (支持明文发送) |
-
PCF_SETXCHAR
- 0x0020
|
支持可设置的 XON/XOFF |
-
PCF_SPECIALCHARS
- 0x0100
|
提供特殊字符支持 |
-
PCF_TOTALTIMEOUTS
- 0x0040
|
支持的总已用 () 超时 |
-
PCF_XONXOFF
- 0x0010
|
支持 XON/XOFF 流控制 |
dwSettableParams
一个位掩码，指示可以更改的通信参数。 此成员可以是以下值的组合。
| 值 |
含义 |
-
SP_BAUD
- 0x0002
|
波特率 |
-
SP_DATABITS
- 0x0004
|
数据位 |
-
SP_HANDSHAKING
- 0x0010
|
握手 (流控制) |
-
SP_PARITY
- 0x0001
|
奇偶校验 |
-
SP_PARITY_CHECK
- 0x0020
|
奇偶校验检查 |
-
SP_RLSD
- 0x0040
|
RLSD (receive-line-signal-detect) |
-
SP_STOPBITS
- 0x0008
|
停止位 |
dwSettableBaud
可以使用的波特率。 有关值，请参阅 dwMaxBaud 成员。
wSettableData
一个位掩码，指示可设置的数据位数。 此成员可以是以下值的组合。
| 值 |
含义 |
-
DATABITS_5
- 0x0001
|
5 个数据位 |
-
DATABITS_6
- 0x0002
|
6 个数据位 |
-
DATABITS_7
- 0x0004
|
7 个数据位 |
-
DATABITS_8
- 0x0008
|
8 数据位 |
-
DATABITS_16
- 0x0010
|
16 个数据位 |
-
DATABITS_16X
- 0x0020
|
通过串行硬件线的特殊宽路径 |
wSettableStopParity
一个位掩码，指示可以选择的停止位和奇偶校验设置。 此成员可以是以下值的组合。
| 值 |
含义 |
-
STOPBITS_10
- 0x0001
|
1 停止位 |
-
STOPBITS_15
- 0x0002
|
1.5 个停止位 |
-
STOPBITS_20
- 0x0004
|
2 个停止位 |
-
PARITY_NONE
- 0x0100
|
无奇偶校验位 |
-
PARITY_ODD
- 0x0200
|
奇数奇偶校验 |
-
PARITY_EVEN
- 0x0400
|
偶等奇偶校验 |
-
PARITY_MARK
- 0x0800
|
标记奇偶校验 |
-
PARITY_SPACE
- 0x1000
|
空间奇偶校验 |
dwCurrentTxQueue
驱动程序的内部输出缓冲区的大小（以字节为单位）。 如果值为零，则表示该值不可用。
dwCurrentRxQueue
驱动程序的内部输入缓冲区的大小（以字节为单位）。 如果值为零，则表示该值不可用。
dwProvSpec1
任何特定于提供程序的数据。 应用程序应忽略此成员，除非它们具有有关提供程序所需数据格式的详细信息。
在调用 GetCommProperties 函数之前将此成员设置为 COMMPROP_INITIALIZED，以指示 wPacketLength 成员已有效。
dwProvSpec2
任何特定于提供程序的数据。 应用程序应忽略此成员，除非它们具有有关提供程序所需数据格式的详细信息。
wcProvChar[1]
任何特定于提供程序的数据。 应用程序应忽略此成员，除非它们具有有关提供程序所需数据格式的详细信息。
dwProvSpec1、dwProvSpec2 和 wcProvChar 成员的内容取决于由 dwProvSubType 成员) 指定的提供程序子类型 (。
如果提供程序子类型 PST_MODEM，则按如下所示使用这些成员。
| 值 |
含义 |
|
dwProvSpec1 |
未使用。 |
|
dwProvSpec2 |
未使用。 |
|
wcProvChar |
包含 MODEMDEVCAPS 结构。 |
要求
| |
|
|
最低受支持的客户端 |
Windows XP |
|
最低受支持的服务器 |
Windows Server 2003 |
|
标头 |
winbase.h (包括 Windows.h) |
另请参阅
GetCommProperties