Dialogic 6.2 manual Fax Functions

The Bfv API Functions

Fax Functions

The Bfv API provides a wealth of fax functions that allow you to control every aspect of sending and receiving V.17 or V.34 faxes.

The fax functions are divided into high-, mid-, and low-level functions. Volume 4, Fax Processing, Bfv API Reference Manual provides a detailed description of each Bfv function.

Generally, the high-level functions simplify the process of transmitting and receiving facsimiles. Since the high-level functions incorporate many of the appropriate low-level functions to automatically perform the basic low-level tasks, applications using the high-level functions are freed to perform other tasks. For example, the high-level function BfvFaxSend is constructed of these mid- and low-level functions:

BfvFaxBeginSend

BfvFaxEndOfDocument

BfvFaxGetRemoteInfo

BfvFaxSendPage

BfvFaxSetLocalId

BfvFaxWaitForTraining

The high-level functions trade the maximum flexibility and control provided by the low-level functions for ease of programming.

The mid-level functions provide more flexibility and control than the corresponding high-level functions, but they require more knowledge of and attention to the basic steps involved in sending and receiving facsimiles.

The low-level functions provide the greatest flexibility and control over sending and receiving facsimiles, but they require extensive knowledge of and attention to the basic steps involved in each of these tasks. For example, applications can screen phone calls based on an ID string or NSF information with the low-level functions, but not with the high-level functions.

Both the high- and mid-level functions use only infopkt files, so the distinction between them is measured in the flexibility and control they provide. The low-level functions, however, use only raw data files.

November 2009 40