包含通訊驅動程式的相關資訊。
語法
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
|
傳真裝置 |
-
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 (資料終端機就緒) /DSR (資料集就緒) |
-
PCF_INTTIMEOUTS
- 0x0080
|
支援的時間間隔逾時 |
-
PCF_PARITY_CHECK
- 0x0008
|
支援的同位檢查 |
-
PCF_RLSD
- 0x0004
|
支援 RLSD (接收線訊號偵測) |
-
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
|
Parity |
-
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 |
包含 數據機DEVCAPS 結構。 |
規格需求
| |
|
|
最低支援的用戶端 |
Windows XP |
|
最低支援的伺服器 |
Windows Server 2003 |
|
標頭 |
winbase.h (包含 Windows.h) |
另請參閱
GetCommProperties