dx_setsvcond( )

Description | Cautions | Example | Errors | See Also

Name:	int dx_setsvcond( chdev, numblk, svcbp)
Inputs:	int chdev	valid channel device handle
	unsigned short numblk	number of DX_SVCB blocks
	DX_SVCB * svcbp	pointer to array of DX_SVCB structures
Returns:	0 if success
	-1 if failure
Includes:	srllib.h
	dxxxlib.h
Category:	Speed and Volume

Description

The dx_setsvcond( ) function sets adjustments and adjustment conditions for all subsequent plays on the specified channel (until changed or cancelled). An "adjustment" is a modification to play-speed or play-volume that takes place due to an "adjustment condition" such as start of play, or the occurrence of an incoming digit during play. This function uses the specified channel's speed or volume Speed/Volume Modification Table. Detailed information about these tables are contained in the Voice Software Reference: Voice Features Guide.

NOTE:

Calls to dx_setsvcond( ) are cumulative. If adjustment blocks have been set previously, calling this function adds more adjustment blocks to the list. To replace existing adjustment blocks, clear the current set of blocks using dx_clrsvcond( ) before issuing a dx_setsvcond( ).

The following adjustments and adjustment conditions are defined in the Speed/Volume Adjustment Condition Blocks DX_SVCB):

• which Speed/Volume Modification Table to use (speed or volume)
• adjustment type (increase/decrease, absolute value, toggle)
• adjustment conditions (incoming digit, beginning of play)
• level/edge sensitivity for incoming digits

See the chapter on Data Structures for a full description of the DX_SVCB structure. Up to 20 DX_SVCB blocks can be specified in the form of an array.

NOTES:

1. This function is similar to dx_adjsv( ). Use dx_adjsv( ) to explicitly adjust the play immediately and use dx_setsvcond( ) to adjust the play in response to specified conditions. See the description of dx_adjsv( ) for more information.

2. Whenever the play is started its speed and volume is based on the most recent modification.

Parameter	Description
chdev	specifies the valid channel device handle obtained by a call to dx_open( ).
numblk	specifies the number of DX_SVCB blocks in the array. Set to a value between 1 and 20.
svcbp	points to an array of DX_SVCB structures.

Cautions

1. Condition blocks can only be added to the array (up to a maximum of 20). To reset or remove any condition, you should clear the whole array, and reset all conditions if required. (e.g., If DTMF digit 1 has already been set to increase play-speed by one step, a second call that attempts to redefine digit 1 to the origin, will have no affect. The digit will retain its original setting).
2. The digit that causes the play adjustment will not be passed to the digit buffer, so it cannot be retrieved using dx_getdig( ) or ATDX_BUFDIGS( ).
3. Digits that are used for play adjustment will not be used as a terminating condition. If a digit is defined as both, then the play adjustment will take priority.

Example

#include <stdio.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
   
/*  
 * Global Variables  
 */  
DX_SVCB svcb[ 10 ] = {
  
   /*  BitMask  AjustmentSize  AsciiDigit  DigitType */  
   { SV_SPEEDTBL | SV_RELCURPOS,   1, '1', 0 },   /* 1 */  
   { SV_SPEEDTBL | SV_ABSPOS,     -4, '2', 0 },   /* 2 */  
   { SV_VOLUMETBL | SV_ABSPOS,     1, '3', 0 },   /* 3 */  
   { SV_SPEEDTBL | SV_ABSPOS,      1, '4', 0 },   /* 4 */  
   { SV_SPEEDTBL | SV_ABSPOS,      1, '5', 0 },   /* 5 */  
   { SV_VOLUMETBL | SV_ABSPOS,     1, '6', 0 },   /* 6 */  
   { SV_SPEEDTBL | SV_RELCURPOS,  -1, '7', 0 },   /* 7 */  
   { SV_SPEEDTBL | SV_ABSPOS,      6, '8', 0 },   /* 8 */  
   { SV_VOLUMETBL | SV_RELCURPOS, -1, '9', 0 },   /* 9 */  
   { SV_SPEEDTBL | SV_ABSPOS,      10, '0', 0 },   /* 10 */ };  
   
main()  
{  
   int  dxxxdev;  
   
   /*  
    * Open the Voice Channel Device and Enable a Handler  
    */  
   if ( ( dxxxdev = dx_open( "dxxxB1C1", NULL) ) == -1 ) {  
      perror( "dxxxB1C1" );  
      exit( 1 );  
   }  
   
   /*  
    * Set Speed and Volume Adjustment Conditions  
    */  
   if ( dx_setsvcond( dxxxdev, 10, svcb ) == -1 ) {  
      printf( "Unable to Set Speed and Volume" );  
      printf( " Adjustment Conditions\n" );  
      printf( "Lasterror = %d  Err Msg = %s\n",  
         ATDV_LASTERR( dxxxdev ), ATDV_ERRMSGP( dxxxdev ) );  
      dx_close( dxxxdev );  
      exit( 1 );  
   }  
   
   /*  
    * Continue Processing  
    *   .  
    *   .  
    *   .  
    */  
   
   /*  
    * Close the opened Voice Channel Device  
    */  
   if ( dx_close( dxxxdev ) != 0 ) {  
      perror( "close" );  
   }  
   /* Terminate the Program */  
   exit( 0 );  
}

Errors

If this function returns -1 to indicate failure, use ATDV_LASTERR( ) and ATDV_ERRMSGP( ) to retrieve one of the following error reasons:

EDX_BADPARM	Invalid Parameter
EDX_BADPROD	Function not supported on this board
EDX_SVADJBLKS	Invalid Number of Speed/Volume Adjustment blocks
EDX_SYSTEM	Error from operating system; use dx_fileerrno( ) to obtain error value

See Also

Setting Speed and Volume conditions:

• dx_clrsvcond( )
• DX_SVCB structure

Related to Speed and Volume:

• dx_setsvmt( )
• dx_getcursv( )
• dx_getsvmt( )
• dx_adjsv( )
• Speed and Volume Modification Tables (Voice Software Reference: Voice Features Guide)

Click here to contact Dialogic Customer Engineering