Serial Port I/O Function: Establishes the connection to a serial port and defines certain usage parameters.
Module: USE IFPORT
Syntax
result = SPORT_CONNECT (port [, options])
port
(Input) Integer. The port number of connection. The routine will open COMn, where n is the port number specified.
options
(Input; optional) Integer. Defines the connection options. These options define how the nnn_LINE routines will work and also effect the data that is passed to the user. If more than one option is specified, the operator .OR. should be used between each option. Options are as follows:
| Option | Description |
|---|---|
| DL_TOSS_CR | Removes carriage return (CR) characters on input. |
| DL_TOSS_LF | Removes linefeed (LF) characters on input. |
| DL_OUT_CR | Causes SPORT_WRITE_LINE to add a CR to each record written. |
| DL_OUT_LF | Causes SPORT_WRITE_LINE to add a LF to each record written. |
| DL_TERM_CR | Causes SPORT_READ_LINE to terminate READ when a CR is encountered. |
| DL_TERM_LF | Causes SPORT_READ_LINE to terminate READ when a LF is encountered. |
| DL_TERM_CRLF | Causes SPORT_READ_LINE to terminate READ when CR+LF is encountered. |
If options is not specified, the following occurs by default:
(DL_OUT_CR .OR. DL_TERM_CR .OR. DL_TOSS_CR .OR. DL_TOSS_LF)
This specifies to remove carriage returns and linefeeds on input, to follow output lines with a carriage return, and to return input lines when a carriage return is encountered.
Results
The result type is INTEGER(4). The result is zero if successful; otherwise, a Windows* error value.
Compatibility
CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB
See Also
SPORT_RELEASE, Communications and Communications Functions in the Microsoft* Platform SDK, Building Applications: Using the Serial I/O Port Routines
Example
USE IFPORT
INTEGER(4) iresult
iresult = SPORT_CONNECT( 2 )
END