ATFX_CHTYPE( )

Description | Example | Errors | See Also

Name:	long ATFX_CHTYPE(dev)
Inputs:	int dev	fax channel device handle
Returns:	fax channel base hardware type if successful
	AT_FAILURE if error
Includes:	srllib.h
	dxxxlib.h
	faxlib.h
Category:	extended attribute
Mode:	synchronous

Description

The ATFX_CHTYPE( ) function returns the fax channel's base hardware type.
Valid values are:

Hardware Type Value	Description
DFS_FAX40	VFX/40SC board
DFS_FAX40E	VFX/40ESC board
DFS_FAX40EPLUS	VFX/40ESCplus board
DFS_FAX40EPLUSREX	Dialogic board that supports DSP Fax

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

The base hardware type can be used to determine the capabilities of the fax channel. For more information, see Section 2.4. Key Product Features on page 8.

Example

#include <stdio.h>  
#include <windows.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <faxlib.h>  
int dev;  
main( )  
{  
   /*  
    * Open the channel using fx_open( ) and obtain the Dialogic  
    * FAX device handle in dev.  
    */  
   .  
   .  
   /* Determine channel hardware type. */  
   switch(ATFX_CHTYPE(dev))  {  
   case DFS_FAX40E:  
      /*  
       * Enable VFX/40ESC (return type DFS_FAX40E) supported features:  
       * For example, set FC_RXCODING parameter to DF_MMR to receive  
       * all files in MMR encoding scheme.  
       */  
      .  
      .  
      break;  
   case DFS_FAX40:  
      /* VFX/40SC (return type DFS_FAX40) device */  
      .  
      .  
      break;  
   }  
   .  
}

Errors

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

• An invalid fax channel device handle is specified in dev.
• The channel device handle specified does not have fax support.

See Also

• fx_sendfax( )

Click here to contact Dialogic Customer Engineering