7.3. Fax API Function Restrictions

R4 for DM3 supports all Fax API functions except those noted in Table 14. List of Fax API Functions Restricted and Not Supported. This table lists functions that are either not supported or are supported with certain restrictions on DM3 devices. The nature of the limitation is noted, and if applicable a reference is given to the location of additional details. See the Fax Software Reference for details on each function.

NOTE:

If you execute a standard fax function that is not supported by DM3 boards, it produces an EFX_NOTIMP ("not implemented") error. If you execute a supported fax function with a parameter that is not supported on DM3 boards, it produces an EFX_UNSUPPORTED error.

Table 14. List of Fax API Functions Restricted and Not Supported

Function Name	Notes
ATFX_PHDCMD( )	Limitations: Operator intervention request is not supported. Therefore, DFS_PRI_EOP, DFS_PRI_MPS, DFS_PRI_EOM are not returned by this function.
ATFX_RTNPAGES( )	Not supported.
ATFX_TERMMSK( )	Limitations: Operator intervention request is not supported. Therefore, TM_VOICEREQ is not returned by this function.
ATFX_TFBADTAG( )	Not supported.
ATFX_TFNOTAG( )	Not supported.
ATFX_TFPGBASE( )	Not supported.
ATFX_TRCOUNT( )	Limitations: When an error occurs during a send, this value is reset to zero (0).
fx_close( )	Limitations: If an fx_close( ) is sent in the middle of a fax transmission, the fax is aborted (which is equivalent to issuing fx_stopch( ) and fx_close( )). Do not issue an fx_close( ) during a fax send.
fx_getparm( )	Limitations: The following parameters are not supported and return EFX_INVALARG:    FC_FONT0    FC_FONT3    FC_RTN    FC_RTP    FC_TXSUBADDR    FC_REMOTESUBADDR    FC_ENDDOC (specifically DFS_REMOTESUBADDR)    FC_HDRATTRIB (specifically DF_HDRUNDERLINE and HDR_BOLD) The following parameters are ignored:    FC_RETRYCNT    FC_TFPGBASE    FC_TFTAGCHECK The following parameter is supported, but the user information is not displayed because of a character number limitation:    FC_HDRUSER
fx_loadfont( )	Limitations: Return not implemented.
fx_loadfontfile( )	Limitations: Return not implemented.
fx_open( )	Limitations: See Section 7.1.1. Use Fax Handles Only for Fax Commands.
fx_rcvfax( )	Limitations: Operator intervention request is not supported. Therefore, DF_ACCEPT_VRQ and DF_ISSUE_VRQ bit flags are unsupported.
fx_rcvfax2( )	Limitations: Operator intervention request is not supported. Therefore, DF_ACCEPT_VRQ and DF_ISSUE_VRQ bit flags are unsupported.
fx_rtvContinue( )	Not supported.
fx_sendfax( )	Limitations: 1. Operator intervention request (voice request) is not supported. Therefore, DF_ENABLE_RTV, DF_ACCEPT_VRQ, DF_ISSUE_VRQ, and DF_TXSUBADDR bit flags are unsupported. 2. All DF_IOTT structures are checked before any fax is sent, and a fax is not sent if a bad DF_IOTT structure is included anywhere in the fx_sendfax( ) function. In such a case, a phase B event is not generated even for any initial good DF_IOTT structures.
fx_setparm( )	Limitations: See limitations for fx_getparm( ). For information on enhancements, see section 7.5.4. fx_setparm( ).

Click here to contact Dialogic Customer Engineering