ISpRecoResult (Windows CE 5.0)
This interface enables applications to retrieve information about hypotheses, recognitions, and false recognitions of the SR engine. The interface supports retrieval of the original audio that the SR engine recognized. SAPI can automatically retain the audio for an application using ISpRecoContext::SetAudioOptions. This interface inherits from ISpPhrase.
When to Use
The most common use of this interface is to retrieve the text recognized by the SR engine (see ISpPhrase::GetText).
An application can set interest in SR engine hypotheses by calling ISpEventSource::SetInterest with SPEI_HYPOTHESIS. As each hypothesis event is received, the application can examine the proposed text and update its UI to show dynamic run-time recognition status.
An application can set interest in the failed recognitions of the SR engine by calling ISpEventSource::SetInterest with SPEI_FALSE_RECOGNITION. If a false recognition occurs, the application can examine the audio (or even a partial recognition result) to reprocess the recognition or attempt to process the partially recognized text. SAPI does not require that an SR engine send a phrase with the false recognition event.
Methods
The following table shows the methods for the ISpRecoResult interface.
| Methods | Description |
|---|---|
| GetAlternates | Gets an array of pointers to alternate phrases. |
| GetAudio | Creates an audio stream for a given number of elements. |
| GetRecoContext | Returns the recognition context object that is associated with this result. |
| GetResultTimes | Gets the time information associated with the result. |
| ScaleAudio | Converts the format of the retained audio to a different audio format. |
| Serialize | Creates a serialized copy of the recognition result object. |
| SpeakAudio | Gets and speaks the specified audio. |
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.
See Also
Send Feedback on this topic to the authors