scx_clrevtmsk( )

Description | Cautions | Example | Errors | See Also

Name:	int scx_clrevtmsk(devh, mask)
Inputs:	int devh	SCX160 SCxbus Adapter device handle
	unsigned short mask	Event mask for alarms
Returns:	0 on success -1 on failure
Includes:	scxlib.h
Category:	Configuration
Mode:	synchronous

Description

The scx_clrevtmsk( ) function stops the generation of the alarm events specified in the mask parameter. Only alarm events are supported by this function.

Parameter	Description
devh:	SCX160 SCxbus Adapter device handle
mask:	Indicates one or more of the following event mask equates:   SCXMM_EXT_CLOCK - external clock event mask   SCXMM_FIFO - SCX160 FIFO event mask   SCXMM_SC_CLOCK - SCbus clock event mask   SCXMM_SC_DRIVER - SCbus driver event mask   SCXMM_SCX_CLOCK - SCxbus clock event mask   SCXMM_SCX_DRIVER - SCxbus driver event mask

Cautions

• This function disables alarm notification only for the event(s) specified. If notification for other events was previously enabled or disabled, their status of notification does not change.
• This function will fail if an invalid device handle is specified.

Example

#include <windows.h>  
#include <stdio.h>  
#include <stdlib.h>  
#include <errno.h>  
#include <srllib.h>  
#include <scxlib.h>  
   
int   devh;                         /* SCX160 device handle */  
unsigned short event_mask;          /* Event Mask           */  
   
/* Open SCX160 board */  
if ((devh = scx_open("scxB1", 0)) == -1) {  
     printf("Cannot open board scxB1.  errno = %d \n ", errno);  
     exit(1);  
}  
   
/*  
 * Disable the reporting of all clocking alarms on the SCbus  
 * and on the SCxbus.  
 */  
event_mask = (SCXMM_SCX_CLOCK | SCXMM_SC_CLOCK);  
if (scx_clrevtmsk(devh, event_mask) == -1) {  
     printf("ERROR: scx_clrevtmsk( ) failed, %s \n", ATDV_ERRMSGP(devh));  
     exit(1);  
}  
   
/* Close the SCX160 Board */  
scx_close(devh);

Errors

If the function returns -1, use the SRL Standard Attribute function ATDV_LASTERR( ) to obtain the error code, or you can use the ATDV_ERRMSGP( ) function to obtain a descriptive error message. The error codes returned by ATDV_LASTERR( ) function are listed in Chapter 7.  Errors.

See Also

• scx_getevtmsk( )
• scx_setevtmsk( )

Click here to contact Dialogic Customer Engineering