Dialogic 6.2 - Manual (Page 64)

Developing a Fax Application
November 2009 64
Using Bfv API Fax Functions
The following sections show how to send and receive facsimiles using
the high- and low-level function calls, noninfopkt function calls, and
TIFF-F function calls. It also shows how to send and receive
facsimiles in MR and MMR format, access infopkt streams and
TIFF-F fax files from an application, combine data on a single page
using TIFF-F fax files, interpret fax status information from an
application, and how to use prompt files.
The following declarations are assumed to be in effect for all
examples.
struct args_line_admin args_admin;
struct args_telephone args_tel;
struct args_speech args_speech;
struct args_fax args_fax;
struct args_fax_t30_params args_t30;
struct args_fax_page_params args_page;
struct args_fax_strip_params args_strip;
struct args_tone args_tone;
struct args_download args_download;
struct args_dh args_dh;
struct args_intlimit args_intlimit;
struct args_infopkt args_infopkt;
struct args_tiff args_tiff;
Using High- and Low-Level Functions
The Bfv API library contains both high- and low-level function calls
(see Table 1 on page 41). Several low-level function calls are
combined into one high-level function to provide a quick and easy
method to send or receive a facsimile.
The low-level functions, on the other hand, provide more flexibility
and functionality than the higher level function calls.
Sending a Fax Using High-Level Function Calls
A typical way to
send a fax using the high-level fax function calls is demonstrated
below. Each function is presented in sequential order, and the action
it performs is described beneath it.
BT_ZERO(args_admin);
args_admin.unit = unit;
lp = BfvLineAttach(&args_admin);
Attaches to a free channel and gets a line pointer.