Prosody speech processing: API: sm_besp_read_status

This function is only in Prosody version 1 (see also the conversion guide for further details).

Prototype Definition

int sm_besp_read_status(struct sm_besp_status_parms *statusp)

Parameters

a structure of the following type:

typedef struct sm_besp_status_parms {
	tSMChannelId channel;					/* out */
	tSM_INT status;						/* out */
} SM_BESP_STATUS_PARMS;

Description

This function allows an application to determine which out of all the channels with ongoing speech processing "read" type jobs would most benefit from some application action. The following read type jobs are taken into consideration:

Read Job	Status value returned
Record	As status parameter returned by sm_record_status() in any channel mode

If no such read job exists which could benefit from application activity, then channel will be set to kSMNullChannelId and the call will return an error code of ERR_SM_NO_SUCH_CHANNEL.

Fields

channel (Only in Prosody version 1): The channel whose status is being reported.
status (Only in Prosody version 1): The status of a channel.

Returns

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

ERR_SM_DEVERR - device error
ERR_SM_NO_SUCH_CHANNEL - if call when no speech processing firmware hosted channels allocated or when no work to be done

This function is part of the Prosody speech processing API.