User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 376
Dialogic Corporation
3.4.8 Dialogic
®
Fax Software Reference
Updates to Chapter 3, Fax API for DM3
The following should be added as a note in Section 3.3, Programming
Considerations (PTR# 36674):
• Note: All programmers for Dialogic
®
DM3 fax devices need to be aware that unrouting
cannot be accomplished while the fax device is busy. If faxing is in an unknown state, first
call fx_stopch( ) and when that terminates, then route or unroute via fx_listen( ) or
fx_unlisten( ) respectively.
The following bullet should be added to Section 3.3, Programming Considerations
for Dialogic
®
DM3 Boards (IPY00006570 = PTR# 35992):
• When sending raw and ASCII files, the width of the image is limited to 1728 pixels per
line. The io_width field in the DF_IOTT data structure only supports the DF_WID1728
value.
Update to Section 5.5.6, Sending TIFF/F Files (IPY00006556 = PTR# 35326)
In the “Handling Multi-Page TIFF/F Files” subsection on page 56, the following note
should be added:
• Note: On Dialogic
®
DM3 Boards, DFC_EOM is not supported.
Update to Section 5.5.9, Setting Phase D Continuation Values (IPY00006556 =
PTR# 35326)
In the DFC_EOM row in Table 10 on page 59, the following note should be added:
• Note: On Dialogic
®
DM3 Boards, DFC_EOM is not supported.
Update to Section 5.6.3, Defining a Fax Page Header (IPY00006520 = PTR# 36259)
The first paragraph in this section is incomplete and should be revised as follows.
Fax page header parameters can be set to print a special line of text in a compressed font at the top
of every transmitted fax page. This is referred to as the user-definable page header option in Table
1, “Key Fax Features and Specifications.”
There are two possible formats for the fax page header, which is controlled by the
FC_HDRATTRIB and other FC_HDRname parameters in fx_setparm( ). The default format
specified in FC_HDRATTRIB is DF_HDRFMT1.
To create a custom fax page header, set the FC_HDRATTRIB parameter to DF_HDRFMT2 and set
the FC_HDRUSER2 parameter to the string to be displayed. The string in FC_HDRUSER2 may
contain %R and %P to display the remote ID and page number.
For more information, see the parameter descriptions in the fx_setparm( ) function reference
section.
template_id specifies the template identifier
result indicates the success or failure of the command. This field set to 0 on success, or
one of the following error values if the command fails:
• DTCAS_ERR_TEMPLATE_NOT_DEFINED – The template was not found in
the template table
• DTCAS_ERR_TEMPLATE_TABLE_EMPTY – The template table is empty; no
templates are defined
• DTCAS_ERR_END_TMPL_TABLE- The next template was not found; no
other templates are defined