ATFX_BADIOTT( )

Description | Example | Errors

Name:	DF_IOTT * ATFX_BADIOTT(dev)
Inputs:	int dev	fax channel device handle
Returns:	pointer to invalid DF_IOTT if successful
	AT_FAILUREP if error
Includes:	srllib.h
	dxxxlib.h
	faxlib.h
Category:	extended attribute
Mode:	synchronous

Description

The ATFX_BADIOTT( ) function returns a pointer to an invalid DF_IOTT structure if one is detected after transmission begins. If a bad DF_IOTT structure is detected, a TFX_FAXERROR event occurs and ATDV_LASTERR( ) returns the error EFX_BADIOTT.

See the Voice Software Reference - Programmer's Guide for information on ATDV_LASTERR( ).

Parameter	Description
Dev	Specifies the channel device handle for the fax channel obtained when the channel was opened.

The value returned by ATFX_BADIOTT( ) at the end of a fax session remains available to the application until a new send is initiated on that channel.

Example

#include <stdio.h>  
#include <windows.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <faxlib.h>  
DF_IOTT iott[10];  
DF_IOTT * badiotp;  
int dev;  
/*  
 * Open the channel using fx_open( ) and obtain the Dialogic  
 * FAX device handle in dev.  
 */  
.  
.  
/* Call fx_sendfax( ) after setting up the DF_IOTT array. */  
if (fx_sendfax(dev, iott, EV_SYNC) == -1) {  
   /* Check if error was due to an invalid DF_IOTT. */  
   if (ATDV_LASTERR(dev) == EFX_BADIOTT) {  
      /* Get pointer to bad DF_IOTT element. */  
      badiotp = ATFX_BADIOTT(dev);  
   }  
   .  
   .  
}

Errors

If one of the following conditions is present, this function fails and returns AT_FAILUREP:

• An invalid fax channel device handle is specified in dev.
• An EFX_BADIOTT error did not occur during the last call to fx_sendfax( ) on the specified channel.

Click here to contact Dialogic Customer Engineering