• 7.1.1. Use Fax Handles Only for Fax Commands
• 7.1.2. Opening Board Devices Not Supported
• 7.1.3. Using Multiple Handles

7. R4 Fax API for DM3

7.1. Fax Device Information

See Section 3.3. CT_DEVINFO: Channel/Timeslot Device Information Data Structure for information on how to identify whether a logical device belongs to DM3 hardware.

In Fax Resource Only Cluster (FROC) configurations (flexible routing), you must issue fx_listen( ) prior to calling fx_sendfax( ), fx_rcvfax( ) or fx_originate( ). Otherwise, these functions will return an error.

7.1.1. Use Fax Handles Only for Fax Commands

R4 on DM3 does not support the use of a voice handle for fax commands; that is, you cannot use the device handle from dx_open( ) to call fax API functions. You must use fx_open( ) to open a channel device for fax processing and use that fax device handle.

7.1.2. Opening Board Devices Not Supported

R4 on DM3 does not support the use of fx_open( ) on a board device; it can only be used on a channel device. As a workaround, use dx_open( ) on the board device followed by ATDV_SUBDEVS( ) to determine the number of subdevices (or channels) available. Then perform fx_open( ) on each subdevice. If fx_open( ) returns -1, then the subdevice does not support fax.

For more information on ATDV_SUBDEVS( ), see the Standard Runtime Library Programmer's Guide.

7.1.3. Using Multiple Handles

Applications that create multiple handles for a single fax device should set the parameters consistently on all the handles that perform fax operations, for example, on fx_sendfax( ) and fx_rcvfax( ).

Click here to contact Dialogic Customer Engineering