Prosody speech processing: API: sm_replay_adjust

Prototype Definition

int sm_replay_adjust(struct sm_replay_adjust_parms *adjustp)

Parameters

a structure of the following type:

typedef struct sm_replay_adjust_parms {
	tSMChannelId channel;					/* in */
	tSMChannelId background;				/* in */
	tSM_INT volume;						/* in */
	tSM_INT agc;						/* in */
	tSM_INT speed;						/* in */
} SM_REPLAY_ADJUST_PARMS;

Description

This call allows an application to alter the replay parameters of the current replay job on the specified output channel. The background, volume, agc, and speed parameters are as for the sm_replay_start() call.

Fields

channel: The channel which is replaying.
background: A channel which is producing a signal to be added to the replay signal or kSMNullChannelId.
volume: The volume adjustment (dB).
agc: Indicator of whether automatic gain control is to be enabled. (non-zero) or not (zero).
speed: The percentage of full speed at which the replay should work. The value zero also represents full speed.

Returns

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

ERR_SM_DEVERR - device error
ERR_SM_NO_REPLAY_IN_PROGRESS - current replay complete or aborted
ERR_SM_BAD_PARAMETER - out of range volume, speed etc

This function is part of the Prosody speech processing API.