共用方式為


COMMPROP 結構 (winbase.h)

包含通訊驅動程式的相關資訊。

語法

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、dwProvSpec2wcProvChar成員的內容取決於dwProvSubType成員所指定的提供者子類型 () 。

如果提供者子類型 PST_MODEM,這些成員會如下所示使用。

意義
dwProvSpec1 未使用。
dwProvSpec2 未使用。
wcProvChar 包含 數據機DEVCAPS 結構。

規格需求

   
最低支援的用戶端 Windows XP
最低支援的伺服器 Windows Server 2003
標頭 winbase.h (包含 Windows.h)

另請參閱

GetCommProperties