Dialogic 6.2 Manuale Utente

Developing a Fax Application

November 2009

64

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;

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. 

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.