Dialogic Dialogic Global Call IP IP Phone User Manual


 
320
Dialogic Corporation
4.26 T.38 Fax Server
Dialogic
®
Global Call API support for T.38 Fax Server is described under the following topics:
T.38 Fax Server Support Overview
Specifying Manual Operating Mode
Initiating a Switch from Audio to T.38 Fax
Associating a T.38 Fax Device with a Media Device When a Fax Request is Received
Accepting/Rejecting a Request to Switch Between Audio and T.38 Fax
Sending a T.38 Fax in a Session Without Audio Established
Receiving a T.38 Fax in a Session Without Audio Established
Sending a Request to Switch from T.38 Fax to Audio
Receiving a Request to Switch from T.38 Fax to Audio
4.26.1 T.38 Fax Server Support Overview
Dialogic
®
Global Call API provides T.38 fax server functionality to support fax-on-demand and
other applications. The functionality includes the ability of an application to:
initiate and complete a T.38 session without an audio connection being first established
switch coders from audio to T.38 fax and back again during a pre-established audio connection
To support T.38 fax functionality, Dialogic
®
Global Call API uses two types of media devices:
a traditional Media device
a new T.38 Fax device
By default, ipmBxCy represents the media device on board x and channel y, which has no fax
capability on HMP. By associating the corresponding voice handle with a fax handle, the ipmBxCy
device represents the fax channel defined by the fax handle, with no voice capability.
Disassociating the voice and fax devices restores the ipmBxCy device voice capability.
The Dialogic
®
Global Call API uses the gc_SetUserInfo( ) function to associate and disassociate a
traditional Media device with a T.38 Fax device when establishing or concluding a T.38 fax
connection. Manual device association must be done before the next Dialogic
®
Global Call API
function that requires fax information:
For H.323, the association must be made before gc_MakeCall( ) on the outbound call side,
and gc_CallAck( ), gc_AcceptCall( ) and gc_AnswerCall( ) on the inbound call side,
whichever occurs first since the underlying “open logical channel” can happen at any of these
times if coder capabilities and fax port information is available.