COM_Read

This function enables an application to receive characters from the serial port.

Syntax

ULONG COM_Read( HANDLE pContext, PUCHAR pTargetBuffer,
ULONG BufferLength );

Parameters

pContext

Pointer to a handle returned by the COM_Open function.

pTargetBuffer

Pointer to valid memory.

BufferLength

Specifies the size, in bytes, of pTargetBuffer.

Return Values

The number of bytes read indicates success. A value of -1 indicates failure.

Remarks

This function sets the buffer and buffer length requested by the caller. It writes the number of bytes transacted and returns the status of the call.

This function is exported to users through the ReadFile function.

This function must obey time-out values set for the serial port.

This function is defined in the Mdd.c file.

See Also

COM_Write