_COMMPROP

include vcomm.inc

_COMMPROP   STRUC
wPacketLength       DW  ?           ;length of structure, in bytes
wPacketVersion      DW  ?           ;version of structure
dwServiceMask       DD  ?           ;see below
dwReserved1         DD  ?           ;reserved; do not use
dwMaxTxQueue        DD  ?           ;max transmit queue size. 0=not used
dwMaxRxQueue        DD  ?           ;max receive queue size. 0=not used
dwMaxBaud           DD  ?           ;maximum baud supported
dwProvSubType       DD  ?           ;see below
dwProvCapabilities  DD  ?           ;see below
dwSettableParams    DD  ?           ;see below
dwSettableBaud      DD  ?           ;see below
wSettableData       DW  ?           ;see below
wSettableStopParity DW  ?           ;see below
dwCurrentTxQueue    DD  ?           ;transmit queue size. 0=unavailable
dwCurrentRxQueue    DD  ?           ;receive queue size. 0=unavailable
dwProvSpec1         DD  ?           ;see below
dwProvSpec2         DD  ?           ;see below
wcProvChar          DW  1 DUP (?)   ;see below
_COMMPROP   ENDS
 

Contains information about a communications port driver. This structure is filled by the _VCOMM_GetCommProperties service.

Members

dwServiceMask

One or more values specifying the services that are implemented by the port driver. The SP_SERIALCOMM bit is always set for communications devices.

dwProvSubType

Communications provider subtype. Can be one of these values:

Value	Meaning
PST_UNSPECIFIED	Unspecified
PST_RS232	RS-232 serial port
PST_PARALLELPORT	Parallel port
PST_RS422	RS-422 port
PST_RS423	RS-423 port
PST_RS449	RS-449 port
PST_FAX	FAX device
PST_SCANNER	Scanner device
PST_NETWORK_BRIDGE	Unspecified network bridge
PST_LAT	LAT
PST_TCPIP_TELNET	TCP/IP Telnet(r)
PST_X25	X.25 port

dwProvCapabilities

Port driver capabilities. Can be one or more of these values:

Value	Meaning
PCF_DTRDSR	Data terminal ready (DTR)/data set ready (DSR) handshaking supported.
PCF_RTSCTS	Request to send (RTS)/clear to send (CTS) handshaking supported.
PCF_RLSD	Receive line signal detect (RLSD) handshaking supported.
PCF_PARITY_CHECK	Parity checking supported.
PCF_XONXOFF	XON/XOFF handshaking supported.
PCF_SETXCHAR	Settable XON/XOFF supported.
PCF_TOTALTIMEOUTS	Total (elapsed) time-outs supported.
PCF_INTTIMEOUTS	Interval time-outs supported.
PCF_SPECIALCHARS	Special character support provided.
PCF_16BITMODE	Special 16-bit mode supported.

dwSettableParams

Communications settings that can be set. Can be one or more of these values:

Value	Meaning
SP_PARITY	Parity
SP_BAUD	Baud rate
SP_DATABITS	Data bits
SP_STOPBITS	Stop bits
SP_HANDSHAKING	Handshaking
SP_PARITY_CHECK	Parity checking
SP_RLSD	RLSD

dwSettableBaud

Available baud rates. Can be one or more of these values:

Value	Meaning
BAUD_075	75 bps
BAUD_110	110 bps
BAUD_134_5	134.5 bps
BAUD_150	150 bps
BAUD_300	300 bps
BAUD_600	600 bps
BAUD_1200	1200 bps
BAUD_1800	1800 bps
BAUD_2400	2400 bps
BAUD_4800	4800 bps
BAUD_7200	7200 bps
BAUD_9600	9600 bps
BAUD_14400	14,400 bps
BAUD_19200	19,200 bps
BAUD_38400	38,400 bps
BAUD_56K	56K bps
BAUD_128K	128K bps
BAUD_USER	Programmable baud rates available

wSettableData

Available settings for data bits per byte. Can be one or more of these values:

Value	Meaning
DATABITS_5	5 data bits
DATABITS_6	6 data bits
DATABITS_7	7 data bits
DATABITS_8	8 data bits
DATABITS_16	Special wide path via serial hardware lines

wSettableStopParity

Available settings for stop bits and parity. Can be one or more of these values:

Value	Meaning
STOPBITS_10	1 stop bit
STOPBITS_15	1.5 stop bits
STOPBITS_20	2 stop bits
PARITY_NONE	No parity
PARITY_ODD	Odd parity
PARITY_EVEN	Even parity
PARITY_MARK	Mark parity
PARITY_SPACE	Space parity

dwProvSpec1, dwProvSpec2, and wcProvChar

Provider-specific data that port drivers can set in various ways. Clients should ignore these fields unless they know how the specific port driver uses them.

See Also

_VCOMM_GetCommProperties