Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 463
create R2/MF forward signal tone — r2_creatfsig( )
!
!!
! Cautions
• The channel must be idle when calling this function.
• Prior to creating the R2/MF tones on a channel, you should delete any previously created user-
defined tones (including non-R2/MF tones) to avoid getting an error for having too many tones
enabled on a channel.
• This function creates R2/MF tones with user-defined tone IDs from 101 to 115, and you
should reserve these tone IDs for R2/MF. If you attempt to create a forward signal tone with
this function and you previously created a tone with the same tone ID, an invalid tone ID error
will occur.
• The maximum number of user-defined tones is on a per-board basis.
!
!!
! Errors
If the function returns -1, use the Standard Runtime Library (SRL) Standard Attribute function
ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive
error message. One of the following error codes may be returned:
EDX_ASCII
Invalid ASCII value in tone template description
EDX_BADPARM
Invalid parameter
EDX_BADPROD
Function not supported on this board
EDX_CADENCE
Invalid cadence component value
EDX_DIGTYPE
Invalid dg_type value in tone template description
EDX_FREQDET
Invalid tone frequency
EDX_INVSUBCMD
Invalid sub-command
SIGI_8 SIGII_8 108
SIGI_9 SIGII_9 109
SIGI_10 SIGII_10 110
SIGI_11 SIGII_11 111
SIGI_12 SIGII_12 112
SIGI_13 SIGII_13 113
SIGI_14 SIGII_14 114
SIGI_15 SIGII_15 115
Note: Either the Group I or the Group II define can be used to specify the forward signal,
because the Group I and Group II defines correspond to the same set of 15 forward signals,
and the same user-defined tones are used for Group I and Group II.