Dialogic 6.2 manual Using Bfv API Fax Functions, Using High- and Low-Level Functions

Developing a Fax Application

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.

November 2009 64