COMMPROP 結構 (winbase.h)

發行項
08/27/2023

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

語法

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

共用方式為

COMMPROP 結構 (winbase.h)

語法

成員

備註

規格需求

另請參閱

意見反應

其他資源