Prosody speech processing: API: sm_ans_listen_for

Prototype Definition

int sm_ans_listen_for(struct sm_ans_listen_for_parms *listenp)

Parameters

*listenp
a structure of the following type: 
typedef struct sm_ans_listen_for_parms {
	tSMChannelId channel;					/* in */
	enum kSMANSMode {
		kSMANSModeDisable,
		kSMANSModeDetect,
	} detection_mode;					/* in */
} SM_ANS_LISTEN_FOR_PARMS;

Description

This call controls detection of the ITU-T V.8 tones ANS and ANSam, which are used in the preliminary stages of modem negotiation.

When a tone is recognised, the recognition event associated with the channel is set and the application can then retrieve a tone identifier for the recognised tone by calling sm_get_recognised().

The module ansam is required by this call.

Fields

channel
The channel on which to listen.
detection_mode
The detection mode to use. One of these values:
kSMANSModeDisable
Stop detecting ANS and ANSam tones.
kSMANSModeDetect
Initiate ANS and ANSam tone detection.

Returns

0 if call completed successfully, otherwise a standard error such as:

This function is part of the Prosody speech processing API.