ATFX_TRCOUNT( )

Description | Example | Errors

Name:	long ATFX_TRCOUNT(dev)
Inputs:	int dev	fax channel device handle
Returns:	number of bytes transferred for fax transfer if successful
	AT_FAILURE if invalid fax device handle specified
Includes:	srllib.h
	dxxxlib.h
	faxlib.h
Category:	extended attribute
Mode:	synchronous

Description

The ATFX_TRCOUNT( ) function returns the number of bytes transferred so far during the current send or receive on the fax channel device specified in dev.

Parameter	Description
dev	Specifies the valid fax channel device handle obtained when the fax channel was opened.

The transfer byte count value returned by ATFX_TRCOUNT( ) at the end of a fax session remains available to the application until a new fax session is initiated on that fax device channel.

Example

#include <windows.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <faxlib.h>  
DF_IOTT iott[10];  
int dev;  
main( )  
{  
   /*  
    * Open the channel using fx_open( ) and obtain the Dialogic  
    * FAX device handle in dev.  
    */  
   .  
   .  
   /*  
    * Call fx_sendfax( ) in synchronous mode after setting  
    * up the DF_IOTT array.   
    */  
   if (fx_sendfax(dev, iott, EV_SYNC) == -1) {  
      printf("Error - %s (error code %d)\n",  
         ATDV_ERRMSGP(dev),ATDV_LASTERR(dev));  
      if (ATDV_LASTERR(dev)==EDX_SYSTEM) {  
           
      }  
   }  
   .  
   .  
   /* Check the transfer count */  
   printf("Transfer count is %d\n", ATFX_TRCOUNT(dev));  
   .  
   .  
}

Errors

This function fails and returns AT_FAILURE if an invalid fax channel device handle is specified in dev.

Click here to contact Dialogic Customer Engineering