Click above to get retro games delivered to your door ever month!

 FaxCancel
 Cancel current operation
------------------------------------------------------------------------------
 Syntax

    FaxCancel(<nDev>)

 Parameters

    <nDev> is a fax device number.

 Description

    FaxCancel() requests the fax device to cancel its operation.  Canceling
    implies an orderly shutdown, with the phone connection hung up and the
    modem reset.  This can take some time--up to 90 seconds in the worst
    case, though usually no more than five or ten.

    FaxCancel() returns immediately.  The process of shutting down the fax
    device takes place in the background, and is complete when the device's
    StMode() value changes from FAX_SEND or FAX_RECV to FAX_DONE.  StError()
    will show an error code of 4003, "Fax canceled locally".

    If the device is idle or the operation is already complete (or so near
    to complete that canceling it is pointless), FaxCancel() has no effect.

 Example

    // Cancel the fax on device 1 and wait till it finishes.

    if StMode(FaxStatus(1)) != FAX_IDLE
        // No point in canceling if it's not doing anything
        FaxCancel(1)
        do while StMode(FaxStatus(1)) != FAX_DONE
            // Give the fax driver a time slice
            FaxDriver()
        enddo
    endif