Transferring Data

Xoff

lgo_Xoff()

Request temporary suspension of data transmission by the remote system.

Syntax
#include "laygo.h"

LResult lgo_Xoff
    (
        LCid    cid
    );
cidconnection on which to effect flow control
Description

lgo_Xoff() requests a temporary suspension of data transmission by the remote system. lgo_Xoff() may be called more than once, without an intervening call to lgo_Xon(), but the effect, if any, is defined by the protocol. For instance, The X.21 bis protocol uses a physical signal for flow control. So multiple xoff requests have no effect. However, an HDLC LAPB implementation may chose to send an RNRframe each time lgo_Xoff() is called.

A successful return from lgo_Xoff() does not prevent the local application from continuing to read and write data and sending control events.

Return Values

If successful, lgo_Xoff() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

See Also

lgo_Xon()

Example
if (cannotProcess)
{
    lgo_Xoff(cid);
}