Tools

LV_SRE_StreamSetParameter

Reference Number: AA-00731 Views: 14733

0 Rating/ Voters

Sets a new value for a stream property.

Function

int LV_SRE_StreamSetParameter(HPORT hport, const char* StreamParameter, unsigned int StreamParameterValue)

Parameters

hport

The port's handle.

StreamParameter

Stream parameter to change. See available Stream Properties.

Version 10.5

Note that in version 10.5, this parameter changed from an int to a const char *, which was to optimize the code internally. This should have minimal effect on users, except to require a recompilation of any code linking to the API when making this transition. Specifically, the defines that can be used in this parameter value were changed in the definition to accommodate this.

StreamParameterValue

New stream parameter value.

Return Values

LV_SUCCESS

No errors; parameter changed correctly.

LV_INVALID_HPORT

The input hport is not a valid one.

LV_FAILURE

The operation failed because the port was shutting down.

LV_INVALID_PROPERTY

The specified parameter does not exist.

LV_EXCEPTION

An exception occurred while processing the request.

Remarks

The streaming parameters set by this function are very important for the Engine to correctly determine when speech begins and ends, which in turn is important for getting accurate recognition. A common problem in a speech applications is that the Engine may cut off the start or end of an utterance if these settings are incorrect.

See our recommended Engine settings for some ideas of how to alter these settings for different types of applications.

Example

// Here, we set the sound format to the standard audio format,
// defined in the header files as ULAW_8khz. The return value is used
// to determine whether audio was successfully established.
SpeechPortReturnValue = LV_SRE_StreamSetParameter(pStreamingUserData->PortHandle, STREAM_PARM_SOUND_FORMAT, audio_format);