Get Hardware Status                              

  The Get Hardware Status function (12H) returns the status of the
  communication hardware.

  Caution:    The values and structure returned by this function are
              hardware-dependent and will vary according to type of
              hardware used to implement the CAS services.  It is
              recommended that you use the Get Current Event (10H) and
              Get Queue Status (11H) functions, or examine the Control
              File, instead of using this function.

  Returned Data Structure

  The format of the data area pointed to by DS:DX is as follows, depending on
  whether the hardware is an Intel SatisFAXtion board or an Intel Connection
  CoProcessor board.  (In the following description, bits that are "set" have
  a value of 1.)

  SatisFAXtion Board:

    Ofs  Len   Description

     0    1    Bit fields indicating the status of the connection:

     1    1    Board State

     CCITT Protocol State:

        2 1 0  Action          State
        0 0 0  Idle            None
        0 0 1  Dialing         A
        0 1 0  Answering       A
        0 1 1  Transmitting    C
        1 0 0  Receiving       C
        1 0 1  Pre-message     B
        1 1 0  Post-message    D
        1 1 1  Disconnect      E

     Current bit rate:

        5 4 3  Bit Rate   Modem Mode
        0 0 0  300 bps    V.21 (HDLC)
        1 0 0  2400 bps   V.27 ter
        1 0 1  4800 bps   V.27 ter
        1 1 0  7200 bps   V.29
        1 1 1  9600 bps   V.29
        001-011 Reserved

     Handset Jack Active (off-hook):

        When this bit is set to 1, neither the fax image modem nor the data
        modem can be used (except for the current connection send or
        receive) until the device connected to the handset jack has been
        placed back on-hook.

     2    1    Number of KBytes free in the buffer.

     3    1    Number of pages or files in the buffer

     4    1    Number of retries left to dial this number.  The user sets
               the initial retry value in the SatisFAXtion SETUP program.
               The value is then automatically decremented each time a
               call is attempted.

     5    1    Fax page number to retransmit.  Used in conjunction with the
               "request for retransmit of last page" flag (offset 0, bit 5).

     6    1    Current block transfer page or file.  Number of the current
               page or file that is being transferred between the
               resident manager and the board (not necessarily the page
               or file that is currently being transmitted over the phone
               line).

     7    1    Number of rings detected when receiving a call.  Rings are
               counted only if auto-answer is enabled.

     8    2    Error count.  A 16 bit unsigned integer (byte 9 is most
               significant byte) that indicates the number of errors that
               have occurred during the connection.

     10   4    Length of file being transferred in file transfer mode.

     14   6    Reserved

     20   1    The character "B" if the SatisFAXtion board is present.

     21   13   Transfer agent name; ASCII string, null terminated.

     34   5    Transfer agent version number; ASCII string, null
               terminated.

     39   13   Resident loader name; ASCII string; null terminated.

     52   5    Resident loader version number; ASCII string, null
               terminated.

     57   21   Remote CSID; ASCII string, null terminated.

     78   13   Resident manager name; ASCII string, null terminated.

     91   5    Resident manager version number; ASCII string, null
               terminated.

     96   32   Reserved.

  Connection CoProcessor Board:

    Ofs  Len   Description

     0    1    Bit fields indicating the status of the transmission:

     1    2    Reserved

     3    1    Number of retries left to dial this number.  The user sets
               the initial retry value in the Connection CoProcessor's
               INSTALL or SETUPCC programs.

     4    1    Reserved

     5    1    Bit fields indicating the phone line status:

     Phone Line Status:

        0 0 0  Idle
        0 0 1  Dial
        0 1 0  Answer
        0 1 1  Transmit
        1 0 0  Receive
        1 0 1  Pre-message
        1 1 0  Post-message
        1 1 1  Disconnect

     6    1    Bit fields indicating the baud rate status:

     Bit Rate:

        6 5 4  Bit Rate   Modem Mode
        0 0 0  300 baud   V.21 (HDLC)
        1 0 0  2400 baud  V.27 ter
        1 0 1  4800 baud  V.27 ter
        1 1 0  7200 baud  V.29
        1 1 1  9600 baud  V.29

     7    3    Reserved

     10   1    Bit fields indicating additional hardware status:

     11   1    Bit fields indicating configuration of COM ports,
               Interrupts, and I/O ports:

     COM Port:

        2 1 0  COM Port  IRQ   I/O port
        0 0 1  COM 1    IRQ 4  I/O ports 3F8h - 3FFh
        0 0 0  COM 2    IRQ 3  I/O ports 2F8h - 2FFh
        0 1 1  COM 3    IRQ 4  I/O ports 3E8h - 3EFh
        0 1 0  COM 4    IRQ 3  I/O ports 2E8h - 2EFh
        1 1 1  COM 3    IRQ 5  I/O ports 3E8h - 3EFh
        1 1 0  COM 4    IRQ 2  I/O ports 2E8h - 2EFh

     12   1    Bit fields indicating additional hardware status: