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

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

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

規格需求

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

另請參閱

GetCommProperties