Blocks the client application until a decode is finished.
int LV_SRE_WaitForDecode(HPORT hport, int VoiceChannel);
Zero (0) or greater indicates success. The decode is finished.
A negative result indicates a specific error:
-1: LV_FAILURE: The decode failed.
-6: LV_TIME_OUT: The timeout value associated with PROP_EX_DECODE_TIMEOUT was exceeded before a result was returned from the Speech Engine. The decode was dropped from the Engine, and the LVSpeechPort may now start a new decode request.
VoiceChannel
Which voice channel to wait for. Setting VoiceChannel to -1 will wait on all voice channels for the port.
Some of the API functions run asynchronously, in particular, LV_SRE_Decode. LV_SRE_WaitForDecode is primarily useful when LV_SRE_Decode is called without LV_DECODE_BLOCK. In this case, LV_SRE_Decode returns immediately, but continues processing the voice channel's audio data in a separate thread. Since client applications will eventually need the results, the clients need a way to query the port to see if LV_SRE_Decode has finished. LV_SRE_WaitForDecode will wait the specified time (determined by set value of PROP_EX_DECODE_TIMEOUT) for the engine to idle; check the return value to ensure the decode interaction is finished before attempting to retrieve answers from the speech port
Complete Help Topic List | Speech Engine Product Information