SPORT_READ_DATA (W*32, W*64)

Serial Port I/O Function: Reads available data from the specified port. This routine stalls until at least one character has been read.

Module: USE IFPORT

Syntax

result = SPORT_READ_DATA (port, buffer [, count])

port
(Input) Integer. The port number.


buffer
(Output) Character*(*). The data that was read.


count
(Output; optional) Integer. The count of bytes read.

Results

The result type is INTEGER(4). The result is zero if successful; otherwise, a Windows* error value.

Note

CR and LF characters may not be returned depending on the mode specified in the SPORT_CONNECT( ) call.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also

SPORT_CONNECT, SPORT_PEEK_DATA, SPORT_READ_LINE, SPORT_WRITE_DATA, Communications and Communications Functions in the Microsoft* Platform SDK, Building Applications: Using the Serial I/O Port Routines

Example

USE IFPORT
INTEGER(4)      iresult
INTEGER         count
CHARACTER*1024  rbuff

iresult = SPORT_READ_DATA( 2, rbuff, count )
END