Dialogic 6.2 Manuale Utente

Pagina di 441
The Bfv API Functions
November 2009
40
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.