Intel 05-1832-002 User Manual

Page of 564
462
Voice API for Windows Operating Systems Library Reference — November 2003
r2_creatfsig( ) — create R2/MF forward signal tone
r2_creatfsig( )
create R2/MF forward signal tone 
!
!
!
Description
The r2_creatfsig( ) function is a convenience function that defines and enables leading edge 
detection of an R2/MF forward signal on a channel. This function calls the 
 function to 
create the template.
User-defined tone IDs 101 through 115 are used by this function.
Note:
R2/MF signaling is typically accomplished through the Global Call API. For more information, see 
the Global Call documentation set. The R2/MF function described here is provided for backward 
compatibility only and should not be used for R2/MF signaling.
Name:
int r2_creatfsig(chdev, forwardsig)
Inputs:
int chdev
channel device handle
int forwardsig
group I/II forward signal
Returns:
0 if success
-1 if failure
Includes:
srllib.h
dxxxlib.h
Category:
R2/MF Convenience
Mode:
synchronous
Platform:
Springware 
Parameter
Description
chdev 
specifies the valid channel device handle obtained when the channel was 
opened using 
forwardsig 
specifies the name of a Group I or Group II forward signal which provides the 
tone ID for detection of the associated R2/MF tone (or tones). Set to 
R2_ALLSIG to enable detection of all 15 tones or set to one of the following 
defines:
Group I 
Defines
Group II 
Defines 
Associated 
Tone ID 
SIGI_1
SIGII_1
101
SIGI_2
SIGII_2
102
SIGI_3
SIGII_3
103
SIGI_4
SIGII_4
104
SIGI_5
SIGII_5
105
SIGI_6
SIGII_6
106
SIGI_7
SIGII_7
107