Windows 3.1 Device Drivers (ddag31qh.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
ctx
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
WORD ctx(cid, ch)
int cid;
int ch;
 
The ctx function places a character in a special holding variable to ensure
it will be the next character to be transmitted. The function will return an
error code if the special holding variable already contains a character.
USER calls this function whenever an application calls the TransmitCommChar
function (USER.206).
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
cid        Identifies the communications device.
 
ch         Specifies the character to transmit.
 
Return Value
 
The return value is zero if the function is successful. The return value is
one of the following values if there is an error.
 
Value   Meaning
────────────────────────────────────────────────────────────────────────────
0x8000  The function received an invalid cid parameter.
 
0x4000  The function could not write to the parallel port or there's already
        a character waiting for immediate transmission.
 
Comments
 
The export ordinal for this function is 6.
 
See Also
 
sndcom